Bricks Schema 中文文档：地图（Google）

标签TAGS:

2026年8月30日

📄 原始资料（已截断） | 展开查看原始 JSON（map.json）{ “$schema”: “https://json-schema.org/draft/2020-12/schema”, “$id”: “bricks://elements/map”, “schemaVersion”: “2.3”, “type”: “object”, “title”: “Map (Google)”, “description”: “Schema for Bricks Map (Google) element”, “metadata”: { “name”: “map”, “categ…

📄 原始资料（已截断） | 展开查看原始 JSON（map.json）

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "bricks://elements/map",
  "schemaVersion": "2.3",
  "type": "object",
  "title": "Map (Google)",
  "description": "Schema for Bricks Map (Google) element",
  "metadata": {
    "name": "map",
    "category": "general",
    "tag": "div",
    "nestable": false
  },
  "settings": {
    "address": {
      "label": "Address",
      "hasRequired": true,
      "valueSchema": {
        "type": "string"
      },
      "controlType": "text",
      "labelZh": "地址"
    },
    "addresses": {
      "label": "Addresses",
      "hasRequired": true,
      "valueSchema": {
        "type": "array",
        "items": {
          "type": "object"
        }
      },
      "controlType": "repeater",
      "labelZh": "地址"
    },
    "infoBoxTemplateId": {
      "label": "Info Box",
      "hasRequired": true,
      "valueSchema": {
        "oneOf": [
          {
            "type": "string",
            "description": "Single selection",
            "descriptionZh": "单选。"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Multiple selection",
            "descriptionZh": "多选。"
          }
        ]
      },
      "controlType": "select",
      "labelZh": "信息框"
    },
    "syncQuery": {
      "hasRequired": true,
      "valueSchema": {
        "type": [
          "string",
          "object",
          "array",
          "boolean",
          "number"
        ]
      },
      "controlType": "query-list"
    },
    "mapNoResultsText": {
      "label": "Text",
      "hasRequired": true,
      "valueSchema": {
        "type": "string"
      },
      "controlType": "text",
      "labelZh": "文本"
    },
    "markerCluster": {
      "label": "Cluster",
      "hasRequired": true,
      "valueSchema": {
        "type": "boolean"
      },
      "controlType": "checkbox",
      "labelZh": "聚合标记"
    },
    "markerClusterBgColor": {
      "label": "Cluster",
      "css": [
        {
          "property": "fill",
          "selector": ".brx-map-cluster"
        }
      ],
      "hasRequired": true,
      "valueSchema": {
        "description": "Color value in various formats",
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "hex": {
                "type": "string",
                "pattern": "^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$"
              }
            },
            "required": [
              "hex"
            ]
          },
          {
            "type": "object",
            "properties": {
              "rgb": {
                "type": "string",
                "pattern": "^rgba?\\("
              }
            },
            "required": [
              "rgb"
            ]
          },
          {
            "type": "object",
            "properties": {
              "hsl": {
                "type": "string",
                "pattern": "^hsla?\\("
              }
            },
            "required": [
              "hsl"
            ]
          },
          {
            "type": "object",
            "properties": {
              "raw": {
                "type": "string",
                "description": "Raw color value or CSS variable",
                "descriptionZh": "原始颜色值或 CSS 变量。"
              }
            },
            "required": [
              "raw"
            ]
          }
        ],
        "descriptionZh": "各种格式的颜色值。"
      },
      "controlType": "color",
      "labelZh": "聚合标记"
    },
    "markerClusterTextColor": {
      "label": "Cluster",
      "css": [
        {
          "property": "fill",
          "selector": ".brx-map-cluster text"
        }
      ],
      "hasRequired": true,
      "valueSchema": {
        "description": "Color value in various formats",
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "hex": {
                "type": "string",
                "pattern": "^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$"
              }
            },
            "required": [
              "hex"
            ]
          },
          {
            "type": "object",
            "properties": {
              "rgb": {
                "type": "string",
                "pattern": "^rgba?\\("
              }
            },
            "required": [
              "rgb"
            ]
          },
          {
            "type": "object",
            "properties": {
              "hsl": {
                "type": "string",
                "pattern": "^hsla?\\("
              }
            },
            "required": [
              "hsl"
            ]
          },
          {
            "type": "object",
            "properties": {
              "raw": {
                "type": "string",
                "description": "Raw color value or CSS variable",
                "descriptionZh": "原始颜色值或 CSS 变量。"
              }
            },
            "required": [
              "raw"
            ]
          }
        ],
        "descriptionZh": "各种格式的颜色值。"
      },
      "controlType": "color",
      "labelZh": "聚合标记"
    },
    "markerType": {
      "label": "Type",
      "options": {
        "image": "Image",
        "text": "Text",
        "imageZh": "图片",
        "textZh": "文本"
      },
      "hasRequired": true,
      "valueSchema": {
        "oneOf": [
          {
            "type": "string",
            "description": "Single selection",
            "descriptionZh": "单选。"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Multiple selection",
            "descriptionZh": "多选。"
          }
        ]
      },
      "controlType": "select",
      "labelZh": "类型"
    },
    "googleMapId": {
      "label": "Map ID",
      "hasRequired": true,
      "valueSchema": {
        "type": "string"
      },
      "controlType": "text",
      "labelZh": "地图 ID"
    },
    "mapCenterLat": {
      "label": "Latitude",
      "hasRequired": true,
      "valueSchema": {
        "type": "string"
      },
      "controlType": "text",
      "labelZh": "纬度"
    },
    "mapCenterLng": {
      "label": "Longitude",
      "hasRequired": true,
      "valueSchema": {
        "type": "string"
      },
      "controlType": "text",
      "labelZh": "经度"
    },
    "mapCenterAddress": {
      "label": "Address",
      "hasRequired": true,
      "valueSchema": {
        "type": "string"
      },
      "controlType": "text",
      "labelZh": "地址"
    },
    "localization": {
      "label": "Use page locale",
      "hasRequired": true,
      "valueSchema": {
        "type": "boolean"
      },
      "controlType": "checkbox",
      "labelZh": "使用页面语言环境"
    },
    "height": {
      "label": "Height",
      "units": true,
      "css": [
        {
          "property": "height"
        }
      ],
      "valueSchema": {
        "oneOf": [
          {
            "type": "string",
            "description": "Value with unit (e.g., \"10px\", \"50%\")",
            "descriptionZh": "带单位的值（例如 \"10px\"、\"50%\"）。"
          },
          {
            "type": "number"
          }
        ]
      },
      "controlType": "number",
      "labelZh": "高度"
    },
    "zoom": {
      "label": "Zoom level",
      "valueSchema": {
        "oneOf": [
          {
            "type": "string",
            "description": "Value with unit (e.g., \"10px\", \"50%\")",
            "descriptionZh": "带单位的值（例如 \"10px\"、\"50%\"）。"
          },
          {
            "type": "number"
          }
        ]
      },
      "controlType": "number",
      "labelZh": "缩放级别"
    },
    "type": {
      "label": "Map type",
      "options": {
        "roadmap": "Roadmap",
        "satellite": "Satellite",
        "hybrid": "Hybrid",
        "terrain": "Terrain",
        "roadmapZh": "路线图",
        "satelliteZh": "卫星图",
        "hybridZh": "混合图",
        "terrainZh": "地形图"
 

... (内容过长已截断，完整 JSON 见原始文件)

前言

Bricks Map (Google) 元素的 schema。

基本信息

英文名称：Map (Google)
中文名称：地图（Google）
Schema ID：bricks://elements/map
Schema 版本：2.3
类型：object
分类：general
Tag：div
内部名称：map

设置项

address — 地址 (text)
addresses — 地址 (repeater)
infoBoxTemplateId — 信息框 (select)
syncQuery — syncQuery (query-list)
mapNoResultsText — 文本 (text)
markerCluster — 聚合标记 (checkbox)
markerClusterBgColor — 聚合标记 (color)
markerClusterTextColor — 聚合标记 (color)
markerType — 类型 (select)
googleMapId — 地图 ID (text)
mapCenterLat — 纬度 (text)
mapCenterLng — 经度 (text)
mapCenterAddress — 地址 (text)
localization — 使用页面语言环境 (checkbox)
height — 高度 (number)
zoom — 缩放级别 (number)
type — 地图类型 (select)
loading — 加载 (select)
style — 地图样式 (select)
customStyle — 自定义地图样式 (code)
fitMapOnMarkersChange — 标记变化时适应地图 (checkbox)
scrollwheel — 滚动 (checkbox)
draggable — 可拖动 (checkbox)
fullscreenControl — 全屏控件 (checkbox)
mapTypeControl — 地图类型控件 (checkbox)
streetViewControl — 街景控件 (checkbox)
disableDefaultUI — 禁用默认 UI (checkbox)
disableClickPOI — 禁用可点击 POI (checkbox)
zoomControl — 缩放控件 (checkbox)
minZoom — 缩放级别 (number)
maxZoom — 缩放级别 (number)
_content — 内容 (text)
_margin — 外边距 (spacing)
_padding — 内边距 (spacing)
_width — 宽度 (number)
_widthMin — 最小宽度 (number)
_widthMax — 最大宽度 (number)
_height — 高度 (number)
_heightMin — 最小高度 (number)
_heightMax — 最大高度 (number)
_aspectRatio — 宽高比 (text)
_position — 位置 (select)
_top — 顶部 (number)
_right — 右侧 (number)
_bottom — 底部 (number)
_left — 左侧 (number)
_zIndex — Z 索引 (number)
_order — 顺序 (number)
_display — 显示 (select)
_visibility — 可见性 (select)
_overflow — 溢出 (text)
_opacity — 不透明度 (number)
_cursor — 光标 (select)
_isolation — 隔离 (select)
_mixBlendMode — 混合模式 (select)
_pointerEvents — 指针事件 (text)
_perspective — 透视 (number)
_perspectiveOrigin — 透视原点 (text)
_gridItemJustifySelf — 自身水平对齐 (align-items)
_flexDirection — 方向 (direction)
_alignSelf — 自身对齐 (align-items)
_justifyContent — 主轴对齐 (justify-content)
_alignItems — 交叉轴对齐 (align-items)
_gap — 间距 (number)
_flexGrow — 放大比例 (number)
_flexShrink — 缩小比例 (number)
_flexBasis — 伸缩基准 (text)
_useMasonry — %s 布局 (checkbox)
_masonryColumn — 列数 (number)
_masonryGutter — 间距 (number)
_masonryHorizontalOrder — 水平顺序 (checkbox)
_masonryTransitionDuration — 过渡 (number)
_masonryTransitionMode — 显现动画 (select)
_typography — _typography (typography)
_background — _background (background)
_shapeDividers — 自定义形状 (repeater)
_gradient — _gradient (gradient)
_border — 边框 (border)
_boxShadow — 盒子阴影 (box-shadow)
_transform — 变换 (transform)
_transformOrigin — 变换原点 (text)
_motionElementParallax — 元素视差 (checkbox)
_motionElementParallaxSpeedX — 水平速度 (number)
_motionElementParallaxSpeedY — 垂直速度 (number)
_motionBackgroundParallax — 背景视差 (checkbox)
_motionBackgroundParallaxSpeed — 背景速度 (number)
_motionStartVisiblePercent — 视差起点 (number)
_cssCustom — 自定义 CSS (code)
_cssClasses — CSS 类 (text)
_cssId — CSS ID (text)
_cssFilters — CSS 滤镜 (filters)
_cssTransition — 过渡 (text)
_attributes — 姓名 (repeater)
_scrollSnapType — 类型 (select)
_scrollSnapAlign — 对齐 (select)
_scrollSnapStop — 停止 (select)

补充说明

更多细节可参考 Bricks 官方 Academy 文档。