背景 map-background

背景色图层。

放在 map-2d 的 pieces 里；enabled 写在节点顶层。数据来源 data-input：bind-fields（绑工程连接）或 source（引用数据源）。

在线演示

纯色背景：深蓝底 + 不透明度（background-pattern-mode: 'none'），给空白 CAD 网格图铺出大屏底色。

变体：底色 + 内置「点阵」图案平铺（图案颜色 / 密度 / 点径 / 图案不透明度均可调；不支持渐变，另有 watermark 水印文本、image 图像资源两种图案来源）。

属性

属性	名称	类型	默认	说明
enable-zoom	限制缩放区间	boolean	false
min-zoom	最小级别	number(min=0,max=24,step=0.1)	0
max-zoom	最大级别	number(min=0,max=24,step=0.1)	24
background-color	背景色	color	#0b1a2b
background-opacity	不透明度	slider(min=0,max=100,step=1,unit=%)	100
background-pattern-mode	图案来源	select	none	可选：none / builtin / watermark / image
background-pattern-type	内置图案	select	dots	可选：dots / grid / diagonal / crosshatch
background-pattern-color	图案颜色	color	#3aa1ff
background-pattern-bg	图案底色	color	transparent
background-pattern-size	图案密度	number(unit=px,min=4,max=512)	24
background-pattern-line-width	线宽/点径	number(unit=px,min=0.5,step=0.5)	2
watermark-text	水印文本	string	水印
watermark-color	水印颜色	color	rgba(255,255,255,0.12)
watermark-font-size	字号	number(unit=px,min=8,max=200)	22
watermark-font-family	字体	select	sans-serif	可选：sans-serif / serif / monospace / "Microsoft YaHei", sans-serif / SimHei, sans-serif / SimSun, serif
watermark-bold	加粗	boolean	false
watermark-rotation	旋转角度	number(unit=°,min=-90,max=90)	-30
watermark-gap-x	横向间隔	number(unit=px,min=0,max=400)	40
watermark-gap-y	纵向间隔	number(unit=px,min=0,max=400)	40
background-pattern	背景图案	map-icon	—
background-pattern-opacity	图案不透明度	slider(min=0,max=100,step=1,unit=%)	100
row-row-filter-mode-id	选择数据规则	select(condition)	—

事件

触发器	名称	配在哪	payload
marker-click	点击点要素	map-2d 组件的 options.interactions（运行态按命中图层分流）	命中要素属性行，公式 {:name} / {:value} 取值
region-click	点击面要素	同上	同上
map-select / map-unselect	选中 / 取消	同上	选中项数据

事件写在地图组件上而非图层上。图层还支持 feature-panel-uid（点击要素弹锚定窗口）与 tooltip-enable（悬停浮层），见属性表。动作端可用 mapLayerVisible / mapSetLayerStyle / mapRefreshData 等 17 个地图动作，见 2D 地图 · 事件。

示例

{
  "type": "map-background",
  "uid": "ly_x",
  "enabled": true,
  "options": {
    "background-color": "#123c6e"
  }
}

延伸阅读：2D 地图子系统 · 地图数据源 · 地图图层总览。