# @elfalem/leaflet-curve 中文文档

规范地址：https://npmcn.com/package/%40elfalem/leaflet-curve/

版本：0\.9\.2
npm 元数据更新时间：2023-03-08T00:08:28.106Z
中文译文更新时间：2026-11-13T12:22:35.543Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40elfalem/leaflet-curve
原文对照：https://npmcn.com/package/%40elfalem/leaflet-curve/?lang=original
项目主页：https://github.com/elfalem/Leaflet.curve#readme
源码仓库：https://github.com/elfalem/Leaflet.curve

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：17.8 kB，9 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：leaflet ^1\.1\.0
- 首次发布：2018-11-17T19:49:22.145Z
- 最新版本发布：2023-03-08T00:08:28.019Z
- 近 30 天下载量：37623（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 0 个）

## 中文简介

一个用于绘制贝塞尔曲线等复杂形状的叶片插件.

## 安装

```sh
npm install @elfalem/leaflet-curve
```

也可以使用：`pnpm add @elfalem/leaflet-curve`、`yarn add @elfalem/leaflet-curve`、`bun add @elfalem/leaflet-curve`

## README

# 叶子. 弯曲

A 类 [传单](http://leafletjs.com/) 用于绘制贝塞尔曲线和其他复杂形状的插件 。 ()[德莫尔](http://elfalem.github.io/Leaflet.curve/)(中文(简体) )

### 使用量

如果直接使用, 在叶片后包含插件 :

```
<script src="leaflet.js"></script>
<script src="leaflet.curve.js"></script>
```

(如果使用画布和动画渲染,则包括 [(简体中文)tween.js](https://github.com/tweenjs/tween.js) 也一样。 )

如果使用Node.js,则安装并导入:

```
yarn add @elfalem/leaflet-curve
```

```
import L from 'leaflet'  // import { curve, Curve } from 'leaflet'; // for TypeScript
import '@elfalem/leaflet-curve'
```

添加包含贝塞尔曲线和直线的路径 :

```
var path = L.curve(['M',[50.54136296522163,28.520507812500004],
                    'C',[52.214338608258224,28.564453125000004],
                        [48.45835188280866,33.57421875000001],
                        [50.680797145321655,33.83789062500001],
                    'V',[48.40003249610685],
                    'L',[47.45839225859763,31.201171875],
                        [48.40003249610685,28.564453125000004],'Z'],
                    {color:'red',fill:true}).addTo(map);
```

### 页:1

-   此插件基于Leaflet版本1.1.0.
-   SVG渲染得到最好的支持. Canvas渲染也是可能的.
-   浏览器和设备相容性测试非常有限.

### API 密码

L. Curve () 的第一个参数是一系列路径数据 。 这是由命令和坐标组成的。 命令是 SVG 路径的子集 [规格](http://www.w3.org/TR/SVG/paths.html)。 。 。 .

| 命令 | 参数 | 说明 |
| --- | --- | --- |
| 联合国 | \[高,lng\]+ | 移动到 \[lat,lng\] |
| L | \[高,lng\]+ | 线到 \[lat,lng\] |
| 页:1 | \[lng\]+ | 水平线到 \[lng\] |
| 五、结 论 | \[正 + | 垂直线到\[上\] |
| C级 | (\[lat1,lng1\],\[lat2,lng2\],\[lat,lng\])+ | 立方贝塞尔曲线为\[lat,lng\],控制点为\[lat1,lng1\]和\[lat2,lng2\] |
| 页:1 | (\[拉特2,lng2\], \[拉特,lng\])+ | 立方贝塞尔曲线为\[lat,lng\],控制点为上个曲线的第二个控制点\[lat1,lng1\]和\[lat2,lng2\] |
| Q 问 | (\[拉特1,lng1\], \[拉特,lng\])+ | 四边形贝塞尔曲线为\[lat,lng\],控制点为\[lat1,lng1\] |
| T级 | (\[拉特,lng\])+ | 四边形贝塞尔曲线至\[lat,lng\],控制点为上个曲线的控制点\[lat1,lng1\] |
| 页:1 |  | 关闭路径( 线到 M) |

注意只执行绝对命令(上). 可以将椭圆弧(command 'A')与贝塞尔曲线(the `elliptical-arc` 分支执行此命令, 如果您有兴趣的话).

这个 `L.Curve` 类扩展 `L.Path` 因此从 `L.Path` 备有。 以下新方案和方法由下列部门提出: `L.Curve`。 。 。 .

**选项**

| 选项 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| 动画 | 整数或动画选项对象 | `undefined` | 动画曲线. 它需要一个参数,这个参数是提供给 `options` 参数 [元素. animate( )](https://developer.mozilla.org/en-US/docs/Web/API/Element/animate) 方法。 注:网络动画 API 支持 [变化](http://caniuse.com/#feat=web-animation) 横跨浏览器. |

**方法**

| 方法 | 回返 | 说明 |
| --- | --- | --- |
| 设置Path ()`pathData[]`(中文(简体) ) | `this` | 用给定的命令和坐标数组替换当前路径. |
| 获取 Path () | `pathData[]` | 返回路径中命令和坐标的数组. |
| 设置LatLngs(`pathData[]`(中文(简体) ) | `this` | 无法使用此. setPath ()`pathData[]`)使用L.Polyline和其他Leaflet组件的命名公约. |
| 获取LatLngs () | `pathData[]` | 别用 L. Polyline 和其他Leaflet 组件的命名常规来定义 . |
| 跟踪( r)`samplingDistance[]`(中文(简体) ) | `latLng[]` | 返回在给定距离上位于曲线上的点数组。 采样距离是0到1相容的十进制值,被应用于曲线的每个段(即命令). 见 [德莫尔](http://elfalem.github.io/Leaflet.curve/) 举个例子. |

### 许可证

麻省理工学院

### 捐款

-   欢迎虫子报告和拉出请求!

## 常见问题

### @elfalem/leaflet-curve 是什么？

一个用于绘制贝塞尔曲线等复杂形状的叶片插件\.

### 如何安装 @elfalem/leaflet-curve？

在项目目录运行 npm install @elfalem/leaflet-curve，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：leaflet（^1\.1\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @elfalem/leaflet-curve 支持 TypeScript 吗？

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

### @elfalem/leaflet-curve 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @elfalem/leaflet-curve 可以商用吗？

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

### @elfalem/leaflet-curve 的下载量有多少？

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

### @elfalem/leaflet-curve 还在维护吗？

最新版本 0\.9\.2 发布于 2023/03/08（3 年前）；至今共发布 15 个版本，其中过去 12 个月发布了 0 个；首次发布于 2018/11/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。