地图字段
地图字段
map 字段存储结构化的面向位置的数据。
最适合
- 办公地点
- 地址块
- 基于地图的联系方式部分
- 结构化地点信息
架构示例
{ "name": "officeLocation", "label": "Office Location", "type": "map" }模板用法
<div class="office-location">
{{ officeLocation.address }}
</div>地图渲染示例:
<div class="location-map">
{officeLocation.size(800,500)}
</div>何时使用
当内容确实以地点为导向且应保持为结构化位置数据时,使用 map。
何时不使用
不要在以下情况下使用 map:
- 不需要结构化位置的纯文本地址
- 通用联系信息
如果内容只是简单文本,请使用 textarea 或 text。
运行时行为
地图字段旨在用于结构化位置数据和运行时地图渲染。
典型使用模式包括:
{officeLocation}用于默认地图输出{officeLocation.width(600)}用于宽度受限的输出{officeLocation.height(400)}用于高度受限的输出{officeLocation.size(800,500)}用于显式尺寸
这使得 map 与纯文本地址字段不同。其值不仅仅是文案。它是一个结构化的位置输入,可以呈现交互式地图容器。
技术说明
- 当某个部分需要真实的位置信息行为而不只是地址字符串时,使用
map - 为标签、路线说明或办公室名称保留相邻的文本字段,而不是将段落文字强行放入地图字段
- 当设计需要受控的地图尺寸时,使用方法式的尺寸设置
- 如果页面只需要一行普通地址,请改用
text或textarea