@geolonia/mbgl-gesture-handling

中文文档
1.0.15发布于 2021/05/21MITCommonJS零依赖近 30 天下载 2665

This is a Mapbox GL JS plugin that handles wheel and touch gestures to prevent unexpected zooming and moving for the map embeded in your web site.

原始使用文档
文档目录7 节
  1. Screenshots
  2. PC
  3. Mobile devide
  4. Demo
  5. How to use
  6. Contributing
  7. Note for developers

@geolonia/mbgl-gesture-handling

Build Status npm version

This is a Mapbox GL JS plugin that handles wheel and touch gestures to prevent unexpected zooming and moving for the map embeded in your web site.

Screenshots

PC

Users need to use [alt]|[ctrl] + wheel to zoom them map.

Mobile devide

Users need to use two fingers to move the map.

Demo

https://geolonia.github.io/mbgl-gesture-handling/

How to use

$ npm install @geolonia/mbgl-gesture-handling
import GestureHandling from '@geolonia/mbgl-gesture-handling'

const map = new mapboxgl.Map({
  ...
});

// Defaults
const options = {
  backgroundColor: 'rgba(0, 0, 0, 0.8)',
  textColor: '#ffffff',
  textMessage: 'Use alt + scroll to zoom the map.',
  textMessageMobile: 'Use two fingers to move the map.',
  timeout: 3000,
  modifierKey: 'alt',
}

new GestureHandling(options).addTo(map);

Contributing

$ git clone [email protected]:geolonia/mbgl-gesture-handling.git
$ cd mbgl-gesture-handling
$ npm install
$ npm test
$ npm run build

Note for developers

To publish this module:

$ npm tag x.x.x
$ git push origin x.x.x

版本与发布记录

@geolonia/mbgl-gesture-handling 共发布 4 个版本,首次发布于 2020/03/05;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.0.15latest2021/05/215 年前
1.0.142021/05/215 年前
1.0.132020/06/186 年前
1.0.112020/03/056 年前

关于 @geolonia/mbgl-gesture-handling 的常见问题

@geolonia/mbgl-gesture-handling 是什么?

This is a Mapbox GL JS plugin that handles wheel and touch gestures to prevent unexpected zooming and moving for the map embeded in your web site.

如何安装 @geolonia/mbgl-gesture-handling?

在项目目录运行 npm install @geolonia/mbgl-gesture-handling,或使用 pnpm add / yarn add / bun add。

@geolonia/mbgl-gesture-handling 支持 TypeScript 吗?

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

@geolonia/mbgl-gesture-handling 支持 ESM 还是 CommonJS?

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

@geolonia/mbgl-gesture-handling 可以商用吗?

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

@geolonia/mbgl-gesture-handling 的下载量有多少?

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

@geolonia/mbgl-gesture-handling 还在维护吗?

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