导出(图片/PDF) map-control-export

2026年7月20日大约 3 分钟

导出(图片/PDF) `map-control-export`

导出地图为图片 / PDF 的控件。

类型串：map-control-export　默认尺寸：[220, 40]　分类：地图控件

实时预览

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

示例竖排两个按钮并自定义文案，同时预置了导出默认参数：图片默认 3840px 宽 + 透明背景（img-width / img-transparent），PDF 默认 A3 横版（pdf-preset / pdf-orientation）。导出依赖带 mapid 的 CAD 服务图，空白底座上点击会提示不可用，属正常。

属性

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

basic

属性	名称	类型	默认	说明
`target-map`	关联地图	`element(types=map-2d)`	`[]`
`show-image`	显示导出图片	`boolean`	`true`
`show-pdf`	显示导出PDF	`boolean`	`true`
`toolbar-layout`	排列方向	`select(radioGroup)`	`horizontal`	可选：`horizontal` / `vertical`
`image-label`	图片按钮文字	`string`	`导出图片`
`pdf-label`	PDF按钮文字	`string`	`导出PDF`

button

属性	名称	类型	默认
`btn-bg`	背景	`color`	`rgba(13,22,38,0.82)`
`btn-color`	文字色	`color`	`#e6edf7`
`btn-hover-bg`	悬浮背景	`color`	`rgba(47,123,255,0.42)`
`btn-accent`	主按钮色	`color`	`#2f7bff`
`btn-border-color`	边框色	`color`	`rgba(255,255,255,0.18)`
`btn-radius`	圆角	`number(unit=px,min=0)`	`8`
`btn-font-size`	字号	`number(unit=px,min=8)`	`13`
`btn-gap`	按钮间距	`number(unit=px,min=0)`	`8`

imageDefault

属性	名称	类型	默认	说明
`img-range`	默认范围	`select`	`data`	可选：`view` / `data` / `select`
`img-width`	导出宽度	`number(unit=px,min=64,max=8192)`	`1920`
`img-transparent`	透明背景	`boolean`	`false`
`img-bg`	背景色	`color`	`#ffffff`

pdfDefault

属性	名称	类型	默认	说明
`pdf-preset`	纸张	`select`	`A4`	可选：`A0` / `A1` / `A2` / `A3` / `A4` / `A5` / `Letter` / `Tabloid` / `custom`
`pdf-orientation`	方向	`select(radioGroup)`	`landscape`	可选：`portrait` / `landscape`
`pdf-custom-w`	自定义宽(mm)	`number(min=1)`	`420`
`pdf-custom-h`	自定义高(mm)	`number(min=1)`	`297`
`pdf-geom-dpi`	矢量DPI	`number(min=72,max=2400)`	`600`
`pdf-color-dpi`	图像DPI	`number(min=72,max=2400)`	`400`

数据绑定

无组件特有数据绑定字段（纯样式 / 布局 / 装饰）。

事件

触发器

触发器在预览 / 播放态生效（编辑态点击 = 选中组件）。写在本组件 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-export",
  "uid": "w_map_control_export",
  "options": {
    "position": [40, 40],
    "size": [220, 40]
  }
}

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