MapEventType

MapEventType = object

定义于: src/ui/events.ts:149

MapEventType - 事件名称和事件值之间的映射。这些事件与Map#on方法一起使用。当使用layerId与Map#on方法时，请参考MapLayerEventType。以下示例可用于所有事件。

示例

// 初始化地图
let map = new Map({ // 地图选项 });
// 设置事件监听器
map.on('the-event-name', () => {
  console.log('事件已发生!');
});

属性

boxzoomcancel

boxzoomcancel: MapLibreZoomEvent

定义于: src/ui/events.ts:251

当用户取消"框选缩放"交互，或边界框不满足最小尺寸阈值时触发。参见BoxZoomHandler。

boxzoomend

boxzoomend: MapLibreZoomEvent

定义于: src/ui/events.ts:259

当"框选缩放"交互结束时触发。参见BoxZoomHandler。

boxzoomstart

boxzoomstart: MapLibreZoomEvent

定义于: src/ui/events.ts:255

当"框选缩放"交互开始时触发。参见BoxZoomHandler。

click

click: MapMouseEvent

定义于: src/ui/events.ts:285

当指向设备（通常是鼠标）在地图上同一点按下并释放时触发。

参见

• 测量距离
• 将地图居中于被点击的符号

contextmenu

contextmenu: MapMouseEvent

定义于: src/ui/events.ts:289

当在地图内单击鼠标右键或按下上下文菜单键时触发。

data

data: MapDataEvent

定义于: src/ui/events.ts:311

当地图数据加载完成或更改时触发（由Map#setStyle、Source#setData、addSource、removeSource、addLayer、removeLayer、addImage、removeImage、addSpriteImage、removeSpriteImage引起）；

dataloading

dataloading: MapDataEvent

定义于: src/ui/events.ts:316

当地图开始加载数据时触发（由Map#setStyle、Source#setData、addSource、removeSource、addLayer、removeLayer、addImage、removeImage引起）；

dblclick

dblclick: MapMouseEvent

定义于: src/ui/events.ts:231

当用户双击地图时触发；

drag

drag: MapLibreEvent<MouseEvent | TouchEvent | undefined>

定义于: src/ui/events.ts:130

在拖动交互期间重复触发；

dragend

dragend: MapLibreEvent<MouseEvent | TouchEvent | undefined>

定义于: src/ui/events.ts:135

当拖动交互结束时触发；

dragstart

dragstart: MapLibreEvent<MouseEvent | TouchEvent | undefined>

定义于: src/ui/events.ts:125

当拖动交互开始时触发；

error

error: ErrorEvent

定义于: src/ui/events.ts:321

当地图遇到错误时触发；

idle

idle: MapLibreEvent<undefined>

定义于: src/ui/events.ts:326

当地图完全加载初始样式且所有图块已完成加载时触发，或者当地图已完成到新样式的过渡；在"moveend"事件之后触发；

load

load: MapLibreEvent

定义于: src/ui/events.ts:165

在所有必要资源下载完毕并且地图首次视觉完整渲染后立即触发。

参见

• 绘制GeoJSON点
• 添加实时数据
• 动画点

mousedown

mousedown: MapMouseEvent

定义于: src/ui/events.ts:255

当鼠标按钮在地图内按下时触发；

mousemove

mousemove: MapMouseEvent

定义于: src/ui/events.ts:260

当鼠标在地图内移动时触发；

mouseout

mouseout: MapMouseEvent

定义于: src/ui/events.ts:270

当鼠标离开地图画布时触发；

mouseover

mouseover: MapMouseEvent

定义于: src/ui/events.ts:265

当鼠标进入地图画布时触发；

mouseup

mouseup: MapMouseEvent

定义于: src/ui/events.ts:275

当鼠标按钮在地图内释放时触发；

move

move: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>

定义于: src/ui/events.ts:343

在从一个视图到另一个视图的动画过渡期间重复触发，可能是由用户交互或Map#flyTo等方法引起的。

参见

显示HTML集群及其自定义属性

moveend

moveend: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>

定义于: src/ui/events.ts:185

当地图移动结束时触发，作为用户交互或方法（如Map#flyTo或Map#easeTo）的结果；

movestart

movestart: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>

定义于: src/ui/events.ts:175

当地图开始移动时触发，作为用户交互或方法（如Map#flyTo或Map#easeTo）的结果；

pitch

pitch: MapLibreEvent<MouseEvent | TouchEvent | undefined>

定义于: src/ui/events.ts:155

当地图俯仰角度发生变化时重复触发，作为用户交互或方法的结果；

pitchend

pitchend: MapLibreEvent<MouseEvent | TouchEvent | undefined>

定义于: src/ui/events.ts:160

当地图俯仰角度变化完成时触发，作为用户交互或方法的结果；

pitchstart

pitchstart: MapLibreEvent<MouseEvent | TouchEvent | undefined>

定义于: src/ui/events.ts:150

当地图俯仰角度开始变化时触发，作为用户交互或方法的结果；

projectionchange

projectionchange: MapProjectionEvent

定义于: src/ui/events.ts:211

当地图投影更改时触发，通过Map#setProjection方法；

参见

在球体上显示带有向量地图的球体

remove

remove: MapLibreEvent<undefined>

定义于: src/ui/events.ts:331

当地图被销毁时触发；

render

render: MapLibreEvent<undefined>

定义于: src/ui/events.ts:336

在地图渲染新帧后触发；这是经常触发的事件；性能敏感的代码可能需要节流此事件；

resize

resize: MapLibreEvent<undefined>

定义于: src/ui/events.ts:341

当地图大小发生变化时触发，作为resize操作的结果；

rotate

rotate: MapLibreEvent<MouseEvent | TouchEvent | undefined>

定义于: src/ui/events.ts:105

当地图旋转时重复触发，作为用户交互或方法（如Map#flyTo或Map#easeTo）的结果；

rotateend

rotateend: MapLibreEvent<MouseEvent | TouchEvent | undefined>

定义于: src/ui/events.ts:110

当地图旋转完成时触发，作为用户交互或方法（如Map#flyTo或Map#easeTo）的结果；

rotatestart

rotatestart: MapLibreEvent<MouseEvent | TouchEvent | undefined>

定义于: src/ui/events.ts:100

当地图开始旋转时触发，作为用户交互或方法（如Map#flyTo或Map#easeTo）的结果；

sourcedata

sourcedata: MapSourceDataEvent

定义于: src/ui/events.ts:296

当源中的一个图块加载完成或发生错误时触发；此事件的属性"tile"提供了相关图块信息；

sourcedataloading

sourcedataloading: MapSourceDataEvent

定义于: src/ui/events.ts:301

当源中的一个图块开始加载时触发；

styledata

styledata: MapStyleDataEvent

定义于: src/ui/events.ts:286

当地图的样式加载完成或更改时触发（由Map#setStyle方法引起）；

styledataloading

styledataloading: MapStyleDataEvent

定义于: src/ui/events.ts:291

当地图样式开始加载时触发（由Map#setStyle方法引起）；

styleimagemissing

styleimagemissing: MapStyleImageMissingEvent

定义于: src/ui/events.ts:351

当地图需要但找不到已注册的图像时触发；监听此事件提供了一种创建缺少图像的方法；如果监听器没有添加缺少的图像，则不会渲染图层需要该图像的元素；

参见

将生成的图标添加到地图

terrain

terrain: MapTerrainEvent

定义于: src/ui/events.ts:416

当地形的一个图块加载完成或发生错误时触发；此事件的属性"tile"提供了相关图块信息；

terrainloading

terrainloading: MapTerrainEvent

定义于: src/ui/events.ts:421

当地形的一个图块开始加载时触发；

touchcancel

touchcancel: MapTouchEvent

定义于: src/ui/events.ts:247

当触摸事件被取消时触发；

touchend

touchend: MapTouchEvent

定义于: src/ui/events.ts:242

当触摸事件结束时触发；

touchmove

touchmove: MapTouchEvent

定义于: src/ui/events.ts:216

当触摸移动时触发；

touchstart

touchstart: MapTouchEvent

定义于: src/ui/events.ts:222

当地图内发生触摸开始事件时触发；

参见

创建可拖动点

webglcontextlost

webglcontextlost: MapContextEvent

定义于: src/ui/events.ts:195

当WebGL上下文丢失时触发；

webglcontextrestored

webglcontextrestored: MapContextEvent

定义于: src/ui/events.ts:199

当WebGL上下文恢复时触发；

wheel

wheel: MapWheelEvent

定义于: src/ui/events.ts:410

当地图内发生滚轮事件时触发；

zoom

zoom: MapLibreEvent<MouseEvent | TouchEvent | WheelEvent | undefined>

定义于: src/ui/events.ts:360

在从一个缩放级别到另一个缩放级别的动画过渡期间重复触发，可能是由用户交互或Map#flyTo等方法引起的。