地图字段

地图字段

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

  • 不需要结构化位置的纯文本地址
  • 通用联系信息

如果内容只是简单文本,请使用 textareatext

运行时行为

地图字段旨在用于结构化位置数据和运行时地图渲染。

典型使用模式包括:

  • {officeLocation} 用于默认地图输出
  • {officeLocation.width(600)} 用于宽度受限的输出
  • {officeLocation.height(400)} 用于高度受限的输出
  • {officeLocation.size(800,500)} 用于显式尺寸

这使得 map 与纯文本地址字段不同。其值不仅仅是文案。它是一个结构化的位置输入,可以呈现交互式地图容器。

技术说明

  • 当某个部分需要真实的位置信息行为而不只是地址字符串时,使用 map
  • 为标签、路线说明或办公室名称保留相邻的文本字段,而不是将段落文字强行放入地图字段
  • 当设计需要受控的地图尺寸时,使用方法式的尺寸设置
  • 如果页面只需要一行普通地址,请改用 texttextarea

相关