Marker
概述
绘制Marker
用法示例
// 在地图设置一个marker
FMap.marker([50.5, 30.5]).addTo(map);
创建(Creation)
创建:
创建 | 描述 |
---|---|
FMap.marker( <LatLng> latlng, <Marker options> options? ) | 实例化一个marker对象,给定坐标点与配置项 |
选项(Options)
选项:
选项 | 类型 | 默认值 | 描述 |
---|---|---|---|
icon | FMap.Icon | * | (图标):图标类用来表达注记,参加Icon documentation以了解自定义注记图标的详细信息,默认设置为new FMap.Icon.Default() |
clickable | Boolean | TRUE | (可点击):如果是false,注记则不产生鼠标事件并表现为底层地图的一部分 |
draggable | Boolean | FALSE | (可拖动):决定注记是否可被鼠标或触摸拖动 |
keyboard | Boolean | TRUE | 键盘enter键是否可以在marker间进行切换 |
title | String | '' | 最低地图的缩放级别,覆盖任何minZoom映射层 |
alt | String | '' | 设置图标或图像的alt属性文本 |
zIndexOffset | Number | 0 | 默认情况下,注记图片的叠置顺序由纬度自动设置,如果你想将某一注记放置于其他之上可用这个选项,设置一个较大的值即可,比如1000(或是相反地设置一个较大的负值) |
opacity | Number | 1 | (不透明度):决定注记的不透明度 |
riseOnHover | Boolean | FALSE | (凸显):如果此值为true,则当把鼠标放置于注记之上时,注记会显示与其他注记之上 |
riseOffset | Number | 250 | (凸显补偿):riseOnHover要素凸显时高度的补偿值 |
事件(Events)
事件:
事件 | 类型(Data) | 描述 |
---|---|---|
click | MouseEvent | (点击):当鼠标点击注记时触发 |
dblclick | MouseEvent | (双击):当鼠标双击注记时触发 |
mousedown | MouseEvent | (鼠标按下):当鼠标按下鼠标键时触发 |
mouseover | MouseEvent | (鼠标经过):当鼠标在注记上时触发 |
mouseout | MouseEvent | (鼠标移出):当鼠标离开注记时触发 |
contextmenu | MouseEvent | (文本菜单):当鼠标右击注记时触发 |
dragstart | Event | (拖动开始):当用户拖动注记时触发 |
drag | Event | (拖动):当用户拖动注记时不断触发 |
dragend | DragEndEvent | (拖动结束):当用户停止拖动注记时触发 |
move | Event | (移动):当注记通过定义经纬度而移动时触发,新的坐标包含事件参数 |
add | Event | 添加marker到地图上时触发 |
remove | Event | (删除):当注记在地图上被删除时触发 |
popupopen | PopupEvent | 当marker上的popup打开时触发 |
popupclose | PopupEvent | 当marker上的popup关闭时触发 |
方法(Methods)
方法:
方法 | 参数 | 返回值 | 描述 |
---|---|---|---|
addTo() | <Map> map | this | 在地图上添加注记 |
getLatLng() | 无 | LatLng | 返回当前注记的地理位置 |
setLatLng() | <LatLng> latlng | this | 将注记位置更改到给定点 |
setIcon() | <Icon> icon | this | 更改注记的图标 |
setZIndexOffset() | <Number> offset | this | 更改注记的zIndex offset |
setOpacity() | <Number> opacity | this | 更改注记的透明度 |
update() | 无 | this | 更新注记的位置,在直接更改经纬度对象的坐标时比较有用 |
bindPopup() | <String> html |<HTMLElement> el |<Popup> popup,<Popup options> options? | this | 当点击一个注记时绑定一个特定的HTML内容的弹出窗口,你也可以用Marker中的openPopup方法打开绑定的弹出窗口 |
unbindPopup() | 无 | this | 将先前用bindPopup方法绑定的注记取消 |
openPopup() | 无 | this | 打开先前用bindPopup方法绑定的弹出框 |
getPopup() | 无 | Popup | 返回之前由bindPopup()方法绑定的popup |
closePopup() | 无 | this | 关闭已打开的注记的弹出框 |
togglePopup() | 无 | this | 切换之前由bindPopup()方法绑定的popup |
setPopupContent() | <String> html |<HTMLElement> el | this | 设置此标记下弹出框的HTML内容 |
toGeoJSON() | 无 | Object | 返回marker的GeoJSON表示(GeoJSON Point 功能) |
属性(Interaction handlers)
//在marker进行互动时,启用或禁用某些功能如拖动(详见IHandler方法)的属性,示例:
marker.dragging.disable();
属性:
属性 | 类型 | 描述 |
---|---|---|
dragging | IHandler | Marker dragging handler (by both mouse and touch). |