坐标位置 map-control-coordinate
2026年7月20日大约 3 分钟
坐标位置 map-control-coordinate
随鼠标 / 中心显示坐标的地图控件。
- 类型串:
map-control-coordinate默认尺寸:[196, 70]分类:地图控件
实时预览
下面渲染的是真实组件(与编辑器 / 运行时同源)。修改右侧「样式参数」,左侧预览实时更新;点击底部「全页面查看」可放大。
示例开启了「跟随鼠标 + 投影坐标 + 缩放级别 + 方位角」四类读数并把小数位数调为 2:把鼠标移到右侧地图上,X/Y 读数实时跟随;拖动/缩放地图,缩放与方位行同步刷新。
属性
下表为本组件特有的属性;
position/size/opacity/background/border/ 联动选中 / 筛选等通用参数见组件手册总览。
basic
| 属性 | 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|---|
target-map | 关联地图 | element(types=map-2d) | [] | |
coord-track | 跟随方式 | select(radioGroup) | mouse | 可选:mouse / center |
coord-digits | 小数位数 | number(min=0,max=8) | 5 | |
coord-layout | 排列 | select(radioGroup) | column | 可选:column / row |
display
| 属性 | 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|---|
coord-show-projected | 投影坐标(X/Y) | boolean | true | |
coord-show-lnglat | 经纬度 | boolean | false | |
coord-show-zoom | 缩放级别 | boolean | false | |
coord-show-bearing | 方位角 | boolean | false | |
coord-show-pitch | 俯仰角 | boolean | false | |
coord-show-label | 显示标签 | boolean | true |
appearance
| 属性 | 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|---|
panel-bg | 背景色 | color | rgba(9,18,34,0.55) | |
panel-color | 文字色 | color | #eaf2ff | |
accent | 主题色 | color | #36e0ff | |
panel-font-size | 字号 | number(unit=px,min=8) | 12 | |
panel-radius | 圆角 | number(unit=px,min=0) | 8 | |
panel-border-color | 边框色 | color | rgba(125,205,255,0.24) | |
panel-padding | 内边距 | number(unit=px,min=0) | 9 |
数据绑定
无组件特有数据绑定字段(纯样式 / 布局 / 装饰)。
事件
触发器
触发器在预览 / 播放态生效(编辑态点击 = 选中组件)。写在本组件
options.interactions的groups[].trigger里。
| 触发器 | 名称 | 触发时机 | payload(供动作公式 {:字段} 取值) |
|---|---|---|---|
click | 点击 | 点击本组件时触发 | 无 |
mouseEnter | 鼠标移入 | 指针移入组件时触发 | 无 |
mouseLeave | 鼠标移出 | 指针移出组件时触发 | 无 |
appear | 入场 | 组件出现时触发(配合进场动画) | 无 |
disappear | 离场 | 组件消失时触发(配合退场动画) | 无 |
receiveBehaviorEvent | 接收行为事件 | 收到 sendBehaviorEvent 动作或宿主 ctx.emit 投递的事件时触发(按 eventName 匹配) | 发送方携带的 data |
动作
触发器命中后执行的动作。本组件既可发起动作(配在自己的交互里),也可作为其它组件动作的目标。
| 动作 | 名称 | 说明 |
|---|---|---|
changeOption | 修改设置 | 把本组件(或其它组件)的某个属性改为静态值 / 公式动态值 |
switchState | 切换状态 | 切到多状态里的某个状态(state:"" 回默认态) |
appear / disappear | 进 / 退场动画 | 对目标 opacity 做 0↔100 插值的显隐动画 |
完整动作清单(switchScreen / switchWindow / openUrl / sendBehaviorEvent / transfer / executeScript / requestApi 等)与持久化写法见事件交互。
示例
{
"type": "map-control-coordinate",
"uid": "w_map_control_coordinate",
"options": {
"position": [40, 40],
"size": [196, 70]
}
}