@digitransit-component/digitransit-component-favourite-modal

中文文档
8.0.5发布于 2026/11/09(AGPL-3.0 OR EUPL-1.2)ESM + CJS零依赖构建来源已验证近 30 天下载 2431

digitransit-component favourite-modal module

原始使用文档
文档目录12 节
  1. isModalOpen
  2. handleClose
  3. saveFavourite
  4. cancelSelected
  5. autosuggestComponent
  6. favourite
  7. Properties
  8. lang
  9. FavouriteModal
  10. Parameters
  11. Examples
  12. Installation

@digitransit-component/digitransit-component-favourite-modal

isModalOpen

Required. Whether the dialog is open.

Type: boolean

handleClose

Required. Called when the dialog is closed without saving.

Type: function

saveFavourite

Required. Called with the favourite when the user saves it.

Type: function

cancelSelected

Optional, but needed when editing (favourite has a favouriteId): called after saving and when the user presses Cancel, typically to return to the favourites list. Not used when adding a new favourite.

Type: function

autosuggestComponent

Autosuggest component for searching the location of the favourite.

Type: node

favourite

Optional. Object to prefill the dialog. Having a favouriteId puts the dialog in edit mode.

Type: object

Properties

lang

Optional. Language, fi, en or sv. Defaults to fi.

Type: string

FavouriteModal

A dialog for adding a new favourite place or editing an existing one, built on the HSL design system's Modal. Colors, typography and the mobile/desktop layout are handled by the design system, so the dialog follows the active deployment's theme.

Parameters

  • $0 Object

    • $0.isModalOpen
    • $0.handleClose
    • $0.saveFavourite
    • $0.cancelSelected (optional, default noop)
    • $0.autosuggestComponent
    • $0.favourite (optional, default null)
    • $0.lang (optional, default 'fi')

Examples

<FavouriteModal
  isModalOpen={modalOpen}
  handleClose={handleClose}
  saveFavourite={onSaveFavourite}
  favourite={favourite}
  lang={lang}
  autosuggestComponent={
    <AutoSuggest
      sources={['History', 'Datasource']}
      targets={['Locations', 'CurrentPosition']}
      id="favourite"
      autoFocus={false}
      placeholder="search-address-or-place"
      value={favourite.address || ''}
      selectHandler={setLocationProperties}
      lang={lang}
    />
  }
/>

---

This module is part of the Digitransit-ui project. It is maintained in the HSLdevcom/digitransit-ui repository, where you can create PRs and issues.

Installation

Install this module individually:

$ npm install @digitransit-component/digitransit-component-favourite-modal

版本与发布记录

@digitransit-component/digitransit-component-favourite-modal 共发布 76 个版本,首次发布于 2020/05/26;过去 12 个月发布了 23 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.0.5latest2026/11/094 天前
8.0.42026/11/049 天前
8.0.32026/10/3014 天前
8.0.22026/10/2915 天前
8.0.12026/10/2717 天前
8.0.02026/10/2321 天前

关于 @digitransit-component/digitransit-component-favourite-modal 的常见问题

@digitransit-component/digitransit-component-favourite-modal 是什么?

digitransit-component favourite-modal module

如何安装 @digitransit-component/digitransit-component-favourite-modal?

在项目目录运行 npm install @digitransit-component/digitransit-component-favourite-modal,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.3.1)、i18next(^22.5.1)、classnames(^2.5.1)、prop-types(^15.8.1)、@hsl-fi/form(^5.0.4)、react-i18next(^12.3.1)、@hsl-fi/dialog(^3.1.3)、@hsl-fi/layout-primitives(^4.9.0)、@digitransit-component/digitransit-component-icon(^5.0.5)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@digitransit-component/digitransit-component-favourite-modal 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/digitransit-component__digitransit-component-favourite-modal 是否存在。

@digitransit-component/digitransit-component-favourite-modal 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@digitransit-component/digitransit-component-favourite-modal 可以商用吗?

@digitransit-component/digitransit-component-favourite-modal 使用 (AGPL-3.0 OR EUPL-1.2) 许可。可在 AGPL-3.0、EUPL-1.2 中任选其一遵守。以上为概括,不构成法律意见,请以许可原文为准。

@digitransit-component/digitransit-component-favourite-modal 的下载量有多少?

根据 npm 官方下载统计,@digitransit-component/digitransit-component-favourite-modal 在 2026/10/12 – 2026/11/10 这 30 天内被下载 2,431 次,日均约 81 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@digitransit-component/digitransit-component-favourite-modal 还在维护吗?

最新版本 8.0.5 发布于 2026/11/09(4 天前);至今共发布 76 个版本,其中过去 12 个月发布了 23 个;首次发布于 2020/05/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。