<QMapMarker />
Component API
Props
Prop |
Type |
Default |
Note |
title |
String |
|
设置 Marker 的标题. 当仅设置 <QMapMarker /> 而不给它附加 <QMapCallout /> 时,将展示一个默认的使用 Marker 的 title 与 description 的气泡(当设置这两个属性时)。 |
description |
String |
|
设置 Marker 的描述. 当仅设置 <QMapMarker /> 而不给它附加 <QMapCallout /> 时,将展示一个默认的使用 Marker的 title 与 description 的气泡当设置这两个属性时)。 |
image |
ImageSource |
|
用于渲染 Marker 的图片 |
coordinate |
LatLngWithType |
|
Marker 的位置 |
flat |
Boolean |
false |
是否平贴地图(仅 Adr 生效) |
identifier |
String |
|
id |
draggable |
Boolean |
false |
是否可以拖拽 |
stopPropagation |
Boolean |
false |
停止 onPress 事件的传递,设置为 true 时将阻止 MapView 的 onPress 事件被触发 Note: iOS only. Android 不会传递 onPress 事件 #1132 |
opacity |
Float |
1.0 |
Marker 透明度 |
calloutOffset |
Float |
Marker高度 |
控制气泡偏移量,仅能控制 y 值偏移量,如:10(正数为向上偏移)(Adr: 60001232生效) |
centerOffset |
Point |
Marker点渲染偏移 |
控制Maker渲染时相对于坐标点的偏移,正方向为向右向下,(Android仅支持y轴) |
zIndex |
Integer |
11 |
控制Marker显示图层,数字越大显示时会在上层,不指定时先添加在下层,后添加的在上层,默认地图上路线的zIndex为0,路线的转折点为10,为保证marker显示在路线和转折点之上,框架Api默认设置为11 |
Events
Event Name |
Returns |
Notes |
onPress |
{ coordinate: LatLng, position: Point } |
点击 Marker |
onSelect |
{ coordinate: LatLng, position: Point } |
地图中的 Marker 被选中,当 Callout 出现前回调 Note: iOS only. |
onDeselect |
{ coordinate: LatLng, position: Point } |
地图中的 Marker 取消选中,当 Callout 消失时回调 Note: iOS only. |
onCalloutPress |
{ coordinate: LatLng, position: Point } |
Callout 被点击 |
onDragStart |
{ coordinate: LatLng, position: Point } |
Marker 开始被拖拽(Marker必须允许拖拽) |
onDrag |
{ coordinate: LatLng, position: Point } |
Marker 被拖拽中(Marker必须允许拖拽) |
onDragEnd |
{ coordinate: LatLng, position: Point } |
Marker 被拖拽完毕,可以通过 setState 重新设置 Marker 的 corrdinate 属性(Marker必须允许拖拽) |
Methods
Method Name |
Arguments |
Notes |
showCallout |
|
显示 Marker 的气泡 |
hideCallout |
|
隐藏 Marker 的气泡 |
Types
type LatLng {
latitude: Number,
longitude: Number,
}
type LatLngWithType {
latitude: Number,
longitude: Number,
isAboard: Boolean,
coordinateType: 'BD09'
}
type Point {
x: Number,
y: Number,
}