# @edv4h/usketch-plugin-edge-pan 中文文档

规范地址：https://npmcn.com/package/%40edv4h/usketch-plugin-edge-pan/

版本：0\.2\.13
npm 元数据更新时间：2026-11-15T14:59:44.708Z
中文译文更新时间：2026-11-16T01:05:43.111Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40edv4h/usketch-plugin-edge-pan
原文对照：https://npmcn.com/package/%40edv4h/usketch-plugin-edge-pan/?lang=original
项目主页：https://github.com/EdV4H/usketch#readme
源码仓库：https://github.com/EdV4H/usketch

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

- 包体积（解压后）：38.2 kB，23 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-09-09T04:35:59.004Z
- 最新版本发布：2026-11-15T14:59:44.304Z
- 近 30 天下载量：1967（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

暂无中文简介

## 安装

```sh
npm install @edv4h/usketch-plugin-edge-pan
```

也可以使用：`pnpm add @edv4h/usketch-plugin-edge-pan`、`yarn add @edv4h/usketch-plugin-edge-pan`、`bun add @edv4h/usketch-plugin-edge-pan`

## README

# @ edv4h/ usketch- plugin- edge- pan

形状**画角の端**\* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \*\* \*\*\*\*\*\*\*\* 形状。

## 仕組み

-   (边距) `BoardStore.panBy` で毎フレーム画角をパンします。速度は**帯の奥ほど速く**(境界で0・端で最大)。
-   パンで画角が動くと、カーソルが止まっていてもドラッグ中のツールは位置を再計算しません(掴んだ). 形状 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #**形状**qq (xq = xq 缩放)。
-   ドラッグ中に動いた 形状 ^ id( 选择 ^ ) → 瞬态 (コマンド化しない ) → 撤消 QQ 投放 QQ 选择 QQ 1 ()`commit()` 店铺 店铺。

## 使い方

```ts
import { createEdgePanPlugin } from "@edv4h/usketch-plugin-edge-pan";

// 既定のまま
createEdgePanPlugin();

// ホスト側で挙動を設定
createEdgePanPlugin({
  edgeSize: 64,      // 反応する端の帯の幅(px)
  maxSpeed: 24,      // 帯の最奥での 1 フレームあたりのパン量(px)
  axes: "both",      // "both" | "horizontal" | "vertical"
  curve: (d) => d * d, // 端に近づくほど急加速（既定は線形）
});
```

## オプション(すべてホストが設定可能)

```ts
interface EdgePanOptions {
  enabled?:  boolean      | (() => boolean);       // 既定 true
  edgeSize?: number       | (() => number);        // 既定 48 (px)
  maxSpeed?: number       | (() => number);        // 既定 16 (px/frame)
  axes?:     EdgePanAxes   | (() => EdgePanAxes);   // 既定 "both"
  curve?:    (depth: number) => number;            // 0..1 → 0..1、既定は線形
}
type EdgePanAxes = "both" | "horizontal" | "vertical";
```

-   **qq 获取( g)`() => value`でも渡せます** - $ 1 的 UI Q( Q) $1 的 $。
-   页:1`edgeSize >= 1`, (中文)`maxSpeed >= 0`) —— i —— (中文(简体) )。

## HUD( 最终用户 )

プロジェクト規約どおり独自 (UI) は持たず、共有 (HUD) に設定グループ「端で画角スライド」を登録します (有効 (p (px)) 最大速度 (対象軸)。**HUD 选择**最终使用者。

## 坐标QQ

`@edv4h/usketch-plugin-snap` 有问题吗 `store.updateShape` をモンキーパッチして、ドラッグ中の位置更新をガイドへスナップします。自動パンの追従移動は「画角補正」であってユーザー操作ではないため、追従はスナップさせずカーソル下へ留めたい(スナップさせると、ワールド固定のガイドに貼り付いてスクロールしても図形が動かなくなる)。

边缘宽度 :**パッチ前の生 `updateShape`** で追従を行うことでこれを回避します。そのため **边缘- 相接- 相接-**\# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #。

## 補足

-   パンは `BoardStore` ======================================`setViewportConstraint`(:仪表板)。
-   ドラッグ検知は `shape:updated`+指向下+% `shapes:move-end` 编号 : `canvas:pointerup`键。

## 常见问题

### 如何安装 @edv4h/usketch-plugin-edge-pan？

在项目目录运行 npm install @edv4h/usketch-plugin-edge-pan，或使用 pnpm add / yarn add / bun add。

### @edv4h/usketch-plugin-edge-pan 支持 TypeScript 吗？

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

### @edv4h/usketch-plugin-edge-pan 支持 ESM 还是 CommonJS？

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

### @edv4h/usketch-plugin-edge-pan 可以商用吗？

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

### @edv4h/usketch-plugin-edge-pan 的下载量有多少？

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

### @edv4h/usketch-plugin-edge-pan 还在维护吗？

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

