事件机制

10/3/2021

无论是前端系统,还是二维/二维GIS应用系统,都离不开各种事件的应用,尤其是鼠标的单击、双击事件。 Mars2D 内大部分类均支持事件的绑定、解绑、触发等统一的事件机制

# 1. 事件的相关类

  1. 事件相关的更多方法可以参阅 Evented类 (opens new window)的API文档。

  2. 事件方法中使用到说支持的事件类型,常见事件类型全部定义在mars2d.EventType (opens new window),不常见的事件类型可以在使用时直接传入字符串的事件名称即可。 在每个对应类的API中都会说明当前类所支持的事件类型,具体参阅各类的API文档。

下面,我们以 map对象为例,绑定一个事件做示例:


function map_clickHandler(event) {
 console.log("鼠标单击", event);
}

//on绑定事件
map.on(mars2d.EventType.click, this.map_clickHandler, this);

//off移除事件
map.off(mars2d.EventType.click, this.map_clickHandler, this);

1
2
3
4
5
6
7
8
9
10
11

# 2. 主要类的常用事件

# 2.1 Map类的事件

目前最重要的Map类支持3类事件类型可以绑定:

  1. Map内部图层变化时的事件,如layeradd、layerremove
  2. 图层、控件等变化触发的事件,如zoom、move、popupopen
  3. 鼠标键盘操作触发的事件,如click、mousemove、mouseout

详细事件列表,请参阅:Map支持的事件类型 (opens new window)

# 2.2 图层类的事件

图层类型可以绑定多种事件,我们已最常用的GraphicLayer图层为例:

  1. 图层内部变化时的事件,如layeradd、layerremove
  2. 鼠标操作触发的事件,如click、mouseover
  3. 标绘和编辑触发的事件,如drawStart、drawCreated、editStart、editStop

详细事件列表,请参阅:GraphicLayer支持的事件类型 (opens new window)

# 2.3 矢量数据类的事件

矢量数据类型可以绑定多种事件,我们已最常用的Entity矢量数据为例:

  1. 数据内部变化时的事件,如move、popupopen
  2. 鼠标操作触发的事件,如click、mouseover

详细事件列表,请参阅:Marker支持的事件类型 (opens new window)

最后更新: 4/27/2022, 9:19:39 PM