区域地图 chart-map

行政区 choropleth 区域地图（按值填色）。需地图标绘请用 2D 地图子系统。

• 类型串：chart-map　默认尺寸：[520, 420]　分类：图表与表格

实时预览

下面渲染的是真实组件（与编辑器 / 运行时同源）。修改右侧「样式参数」，左侧预览实时更新；点击底部「全页面查看」可放大。

属性

下表为本组件特有的属性；position / size / opacity / background / border / 联动选中 / 筛选等通用参数见组件手册总览。

chart

属性	名称	类型	默认	说明
title	标题	string	区域地图
title-show	显示标题	boolean	false
title-color	标题颜色	color	#ffffff
map-region	地图区域	select	china	可选：china / 110000 / 120000 / 130000 / 140000 / 150000 / 210000 / 220000 / 230000 / 310000 / 320000 / 330000 / 340000 / 350000 / 360000 / 370000 / 410000 / 420000 / 430000 / 440000 / 450000 / 460000 / 500000 / 510000 / 520000 / 530000 / 540000 / 610000 / 620000 / 630000 / 640000 / 650000 / 710000 / 810000 / 820000
area-color	区域底色	color	#0c2354
area-border-color	区域边界	color	#1cccff
hover-color	高亮颜色	color	#389bb7
low-color	低值颜色	color	#0c2354
high-color	高值颜色	color	#1cccff
show-label	显示地名	boolean	true
label-color	地名颜色	color	#cfd8e3
show-visualmap	显示色条	boolean	true
enable-roam	允许缩放拖拽	boolean	false

static

属性	名称	类型	默认	说明
demo-regions	区域数值	string	广东:980,江苏:870,山东:760,浙江:650,河南:540,四川:460,湖北:380,福建:320,湖…

数据绑定

字段槽	类型 / 约束	说明
region-field	field(recommend=string,min=1,max=1)	区域名
value-field	field(recommend=number,min=1,max=1)	数值

事件

触发器

触发器在预览 / 播放态生效（编辑态点击 = 选中组件）。写在本组件 options.interactions 的 groups[].trigger 里。

触发器	名称	触发时机	payload（供动作公式 {:字段} 取值）
itemClicked	点击某项	点击图表某个数据项时触发	该项类目维度，如 {城市:"北京"}（仅类目，不含数值）
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": "chart-map",
  "uid": "w_chart_map",
  "options": {
    "position": [40, 40],
    "size": [520, 420],
    "region-field": [["conn_demo", "tbl_demo", "字段名"]],
    "value-field": [["conn_demo", "tbl_demo", "字段名"]]
  }
}

绑定三元组 [连接uid, 表uid, 字段uid] 指向工程 connections 里的真实字段，见数据系统。

变体示例：省级地图 + 暖色系 + 显示地名

map-region 切到省级（此处广东 440000），demo-regions 换成匹配地市名的数值串（区域名需与 geojson 行政区名一致，如「广州市」），开地名标签、允许缩放拖拽，色带换暖色。

延伸阅读：组件手册总览 · 数据系统 · 事件交互。