点标记 (AMap.Marker)

点标记适用于用户需要在地图上创建一个标记的场景。Marker 类型推荐在数据量为 500 以内时使用。若数据量大于 500 ,推荐使用 LabelMarker,可以获得更好的性能。另外需要地图标注可以避让用户标注时,也推荐使用 LabelMarker。

基础示例

静态属性

仅且可以初始化配置,不支持响应式。

名称类型说明
topWhenClickBoolean鼠标点击时marker是否置顶,默认false ,不置顶
bubbleBoolean是否将覆盖物的鼠标或touch等事件冒泡到地图上, 默认值:false。
zoomsArray点标记显示的层级范围,超过范围不显示。默认值:zooms: [2, 20]
anchorString, Array设置点标记锚点,可选值:'top-left','top-center','top-right', 'middle-left', 'center', 'middle-right', 'bottom-left', 'bottom-center', 'bottom-right'
reEventWhenUpdateBoolean是否在组件更新时重新注册事件,主要用于数组更新时,解决绑定了事件但事件的对象不会更新问题,默认false
extraOptionsObject额外扩展属性,会直接将属性拷贝到初始化的options中,当key与props内的一样时会被props覆盖

动态属性

支持响应式。

名称类型说明
visibleBoolean点标记是否可见,默认为true。
zIndexNumber点标记的叠加顺序。地图上存在多个点标记叠加时,通过该属性使级别较高的点标记在上层显示,默认zIndex:12
positionArray点标记在地图上显示的位置1.1.11开始支持支持v-model
offsetArray点标记显示位置偏移量,默认值为 [0,0] 。Marker指定position后,默认以marker左上角位置为基准点(若设置了anchor,则以anchor设置位置为基准点),对准所给定的position位置,若需使marker指定位置对准在position处,需根据marker的尺寸设置一定的偏移量。
iconString AMap.Icon在点标记中显示的图标。可以传一个图标地址,也可以传Icon对象。有合法的content内容设置时,此属性无效。
contentString HTMLElement点标记显示内容。可以是HTML要素字符串或者HTML DOM对象。content有效时,icon属性将被覆盖。 支持slot
draggableBoolean设置点标记是否可拖拽移动,默认为false。
cursorString指定鼠标悬停时的鼠,默认值:'pointer'
angleNumber点标记的旋转角度,,广泛用于改变车辆行驶方向。默认值:0
titleString鼠标滑过点标记时的文字提示。不设置则鼠标滑过点标无文字提示。
clickableBoolean点标记是否可点击,默认值: true
label{content,offset: [x, y]}添加文本标注,content为文本标注的内容,offset为偏移量,为偏移量,如设置了 direction,以 direction 方位为基准点进行偏移。
extDataany用户自定义属 ,支持JavaScript API任意数据类型,如 Marker的id等。可将自定义数据保存在该属性上,方便后续操作使用。

ref 可用方法

提供无副作用的同步帮助方法

函数返回说明
$$getInstance()AMap.Marker获取marker实例

事件

事件参数说明
initAMap.MarkerAMap.Marker实例
clickMapsEvent鼠标左键单击事件
dblclickMapsEvent鼠标左键双击事件
rightclickMapsEvent鼠标右键单击事件
mousemoveMapsEvent鼠标移动
mouseoverMapsEvent鼠标移近点标记时触发事件
mouseoutMapsEvent鼠标移出点标记时触发事件
mousedownMapsEvent鼠标在点标记上按下时触发事件
mouseupMapsEvent鼠标在点标记上按下后抬起时触发事件
dragstartMapsEvent开始拖拽点标记时触发事件
draggingMapsEvent鼠标拖拽移动点标记时触发事件
dragendMapsEvent点标记拖拽移动结束触发事件
moving点标记在执行moveTo,moveAlong动画时触发事件,Object对象的格式是{passedPath:Array.}。其中passedPath为对象在moveAlong或者moveTo过程中走过的路径。
moveend点标记执行moveTo动画结束时触发事件,也可以由moveAlong方法触发
movealong点标记执行moveAlong动画一次后触发事件
touchstartMapsEvent触摸开始时触发事件,仅适用移动设备
touchmoveMapsEvent触摸移动进行中时触发事件,仅适用移动设备
touchendMapsEvent触摸结束时触发事件,仅适用移动设备
最后更新时间:
贡献者: gyy