能力

map

地图占位组件，由宿主地图 provider 提供真实能力。

宿主能力 微信兼容子集 宿主能力：map

使用示例

<map latitude="{{lat}}" longitude="{{lng}}" scale="14" bindregionchange="onRegion" />

属性说明

属性类型默认值必填说明
idstring否节点标识，可用于 label.for 或测试定位。
classstring否附加样式类名。
stylestring否受限内联样式。
hiddenbooleanfalse否是否隐藏当前节点。
data-*string否事件触发时进入 event.dataset。
latitudenumber必填是地图中心纬度。
longitudenumber必填是地图中心经度。
scalenumber16否地图缩放级别。
markersarray[]否地图标记点。
polylinearray[]否地图折线。
show-locationbooleanfalse否是否展示当前位置。

事件说明

事件event.detail说明
bindregionchange{ latitude, longitude, scale }组件状态变化时触发。
bindmarkertap{ latitude, longitude, scale }组件状态变化时触发。
bindtap{ latitude, longitude, scale }点击时触发。

Manifest 声明

能力组件必须声明权限和 API。没有宿主 provider 时，运行时会展示稳定降级态或返回结构化错误。

{
  "permissions": [
    "location",
    "map"
  ],
  "apisUsed": [
    "ac.getMapCenterLocation"
  ]
}

平台支持

平台支持情况
Web支持
Android SDK稳定 fallback；宿主接入 provider 后启用真实能力
iOS SDK稳定 fallback；宿主接入 provider 后启用真实能力
Flutter SDK稳定 fallback；宿主接入 provider 后启用真实能力

渲染协议

字段值
HTML 标签section
样式类mini-map
是否空元素否
必填属性latitude, longitude
必需 APIac.getMapCenterLocation