@bluehalo/ngx-leaflet-markercluster

中文文档
22.0.0发布于 2026/06/16MITTypeScriptES Module近 30 天下载 7.9万

Leaflet Marker 集群插件的 Angular.io 组件

中文使用文档
文档目录8 节
  1. 目录
  2. 安装
  3. 使用量
  4. API 密码
  5. 烹饪本
  6. 贡献
  7. 许可证
  8. 贷项

@ bluehalo/ngx-leaflet-marker 分组

NPM version Build Status Code Coverage

扩展为 Angular.io 的 @ bluehalo/ngx-leaflet 包 为Angular.io项目提供传单。 与Leaflet v1.x和传单相兼容. marker cluster v1.x

目录

安装

通过 npm 安装软件包及其对等依赖性 :

npm install leaflet @bluehalo/ngx-leaflet
npm install leaflet.markercluster @bluehalo/ngx-leaflet-markercluster

如果您打算在打字计划中使用此库( 使用打字), 您还需要通过 npm 安装传单打字:

npm install @types/leaflet @types/leaflet.markercluster

使用量

此插件用于此 Angular.io 叶片插件。 。 。 .

第一步是遵循指示. 接下来,遵循类似的进程安装和配置此插件. 这些步骤一般是:

  • 安装此软件包及其依赖性(见上文).
  • 导入传单. marker 集群样式表(即 , node_modules/leaflet.markercluster/dist/MarkerCluster.Default.css 财务报告和审定财务报表 .../MarkerCluster.css )).
    • 遵循与文件记录相同的程序 @bluehalo/ngx-leaflet。 。 。 .
  • 导入 LeafletMarkerClusterDirective 输入您的角应用模块和本地模块(如果适用).
  • 创建和配置地图(见下文和/或演示文件)

要创建地图,请使用 leaflet 属性指令。 此指令必须先出. 您必须通过 leafletOptions 或通过约束 leafletZoom, (中文(简体) ), leafletCenter,以及 leafletLayers。 。 。 .

<div style="height: 400px;"
     leaflet
     [leafletOptions]="options"
     [leafletMarkerCluster]="markerClusterData"
     [leafletMarkerClusterOptions]="markerClusterOptions">
</div>

API 密码

完整的 API 文档在 文件/API.md它涵盖:

  • [leafletMarkerCluster] ——指令激活和数据输入
  • [leafletMarkerClusterOptions] ——通过选项 leaflet.markercluster
  • [leafletMarkerClusterGroup] ——可选预创建 MarkerClusterGroup (用子插头)
  • (leafletMarkerClusterReady) - 访问该程序的产出活动 MarkerClusterGroup 实例

烹饪本

共同模式和实例 文件/教科书.md,包括:

贡献

公关接受。 请对功能分支投稿 并打开一个吸引请求反对 master。 。 。 .

许可证

见 自由主义 详细情况.

贷项

传单 是一个很棒的地图包. 小册子.标记组 此库包是基本的集群插件 .

版本与发布记录

@bluehalo/ngx-leaflet-markercluster 共发布 10 个版本,首次发布于 2024/06/02;过去 12 个月发布了 4 个版本。

版本发布日期距今
22.0.0latest2026/06/164 个月前
21.1.02026/04/186 个月前
21.0.12026/04/116 个月前
21.0.02026/01/0610 个月前
20.0.32025/06/261.4 年前
20.0.22025/06/251.4 年前

关于 @bluehalo/ngx-leaflet-markercluster 的常见问题

@bluehalo/ngx-leaflet-markercluster 是什么?

Leaflet Marker 集群插件的 Angular.io 组件

如何安装 @bluehalo/ngx-leaflet-markercluster?

在项目目录运行 npm install @bluehalo/ngx-leaflet-markercluster,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@angular/common(22)、@angular/core(22)、@bluehalo/ngx-leaflet(22)、leaflet(1)、leaflet.markercluster(1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bluehalo/ngx-leaflet-markercluster 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bluehalo/ngx-leaflet-markercluster 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@bluehalo/ngx-leaflet-markercluster 可以商用吗?

@bluehalo/ngx-leaflet-markercluster 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@bluehalo/ngx-leaflet-markercluster 的下载量有多少?

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

@bluehalo/ngx-leaflet-markercluster 还在维护吗?

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