Appearance
地图（map）
作用：地理位置。录入坐标或地图位置信息。
功能说明
| 项 | 说明 |
|---|---|
| 类型 type | map |
| 分类 | 高级控件 |
| 作用 | 地理位置 |
| 说明 | 录入坐标或地图位置信息。 |
当前使用情况
当前配置中尚无该组件实例；设计器组件库已注册，可直接拖入。
属性说明
如何新增
- 进入 系统引擎 → 表单引擎，新建或打开表单。
- 从左侧组件库拖入 地图。
- 在右侧属性面板配置标签、绑定列、校验与本控件专属项。
- 保存后刷新运行态表单验证。
控件专用属性
以下仅列出该控件在「控件与数据」区（及本类型独有外观项）中的配置；不含下方共用项。
| 属性 | 名字 | 说明 |
|---|---|---|
| 占位符 | placeholder | — |
| 地图预览高度 | height | — |
共用属性
| 属性 | 名字 | 说明 |
|---|---|---|
| 组件 ID | id | 只读 |
| 组件名称 | name | 设计器内部名称（可选） |
| 所属标签页 | formTabId | 多页签开启时显示；落库 form_tab_id |
| 标签文本 | label | 落库 label |
| 英文标签 | enLabel | 落库 en_label |
| 关联字段 | columnId | 绑定物理列；落库 column_id |
| 组件键名 | key | 脚本与数据映射用 |
| 显示标签 | showLabel | label 控件不显示此项；落库 show_label |
| 是否必填 | required | — |
| 重复校验 | duplicate | — |
| 是否隐藏 | hide | — |
| 是否激活 | isActive | 关闭即禁用；落库 is_active |
| 字段宽度 | width | 行占比：1/4 / 1/3 / 1/2 / 2/3 / 3/4 / full（form、signature 除外） |
条件属性（本控件适用）
按设计器条件函数显示：英文占位符、外观、前后缀、默认值与事件/智能体。
| 属性 | 名字 | 说明 |
|---|---|---|
| 英文占位符 | enPlaceholder | 落库 en_placeholder；仅占位符支持集内的类型显示 |
| 默认值 | defaultValue | 落库 default_value；form / grid / divider / label / button / dynamic-component 不显示 |
| 值变化事件（前端） | frontChangeCommand | 落库 front_change_command；form / grid / divider / label / button 不显示 |
| 失去焦点事件（前端） | frontBlurCommand | 落库 front_blur_command；布局类、button、dynamic-component 不显示 |
| 启用智能体 | isAgent | 与失焦同一支持集；落库 is_agent |
| 智能体 | agentId | isAgent===true 时；落库 agent_id |
| 返回处理方式 | agentCommandType | 0 自动填充 / 1 执行命令；落库 agent_command_type |
| 智能体返回处理（前端） | frontAgentCommand | agentCommandType===1 时；落库 front_agent_command |
保存说明
类型保存为 t_form_component.f_type = 'map'；键 f_key、标签 f_label、绑定列 f_column_id。面板 camelCase 由 Web 映射为接口字段；通用列直接落表，数据源与专属配置按当前请求模型与 DTO 保存。
示例
门店坐标。
text
表单引擎 → 打开表单 → 拖入「地图」→ 右侧属性面板配置 → 保存 → 运行态预览前端脚本可通过 App.Body.Form.Fields['组件key'] 读写该组件。