Bricks Schema 中文文档：轮播图

标签TAGS:

2026年8月30日

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

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

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "bricks://elements/carousel",
  "schemaVersion": "2.3",
  "type": "object",
  "title": "Carousel",
  "description": "Schema for Bricks Carousel element",
  "metadata": {
    "name": "carousel",
    "category": "media",
    "tag": "div",
    "nestable": false
  },
  "settings": {
    "type": {
      "label": "Type",
      "options": {
        "media": "Media",
        "posts": "Posts",
        "mediaZh": "媒体",
        "postsZh": "文章列表"
      },
      "valueSchema": {
        "oneOf": [
          {
            "type": "string",
            "description": "Single selection",
            "descriptionZh": "单选。"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Multiple selection",
            "descriptionZh": "多选。"
          }
        ]
      },
      "controlType": "select",
      "labelZh": "类型"
    },
    "items": {
      "label": "Images",
      "hasRequired": true,
      "valueSchema": {
        "type": "object",
        "properties": {
          "images": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Image settings",
              "properties": {
                "id": {
                  "type": [
                    "string",
                    "integer"
                  ]
                },
                "filename": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "size": {
                  "type": "string"
                },
                "full": {
                  "type": "string"
                },
                "useDynamicData": {
                  "type": "string"
                }
              },
              "descriptionZh": "图像设置。"
            }
          }
        }
      },
      "controlType": "image-gallery",
      "labelZh": "图片"
    },
    "query": {
      "label": "Query",
      "hasRequired": true,
      "valueSchema": {
        "type": "object",
        "description": "Query settings extracted from ControlQuery.vue and PopupQueryApi.vue",
        "properties": {
          "NOTE": {
            "oneOf": [
              {
                "type": [
                  "string",
                  "number",
                  "integer",
                  "boolean",
                  "null"
                ]
              },
              {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": [
                        "string",
                        "number",
                        "integer",
                        "boolean",
                        "null"
                      ]
                    },
                    {
                      "type": "object"
                    },
                    {
                      "type": "array"
                    }
                  ]
                }
              },
              {
                "type": "object",
                "additionalProperties": {
                  "oneOf": [
                    {
                      "type": [
                        "string",
                        "number",
                        "integer",
                        "boolean",
                        "null"
                      ]
                    },
                    {
                      "type": "object"
                    },
                    {
                      "type": "array"
                    }
                  ]
                }
              }
            ]
          },
          "ajax_loader_animation": {
            "oneOf": [
              {
                "type": [
                  "string",
                  "number",
                  "integer",
                  "boolean",
                  "null"
                ]
              },
              {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": [
                        "string",
                        "number",
                        "integer",
                        "boolean",
                        "null"
                      ]
                    },
                    {
                      "type": "object"
                    },
                    {
                      "type": "array"
                    }
                  ]
                }
              },
              {
                "type": "object",
                "additionalProperties": {
                  "oneOf": [
                    {
                      "type": [
                        "string",
                        "number",
                        "integer",
                        "boolean",
                        "null"
                      ]
                    },
                    {
                      "type": "object"
                    },
                    {
                      "type": "array"
                    }
                  ]
                }
              }
            ]
          },
          "ajax_loader_color": {
            "oneOf": [
              {
                "type": [
                  "string",
                  "number",
                  "integer",
                  "boolean",
                  "null"
                ]
              },
              {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": [
                        "string",
                        "number",
                        "integer",
                        "boolean",
                        "null"
                      ]
                    },
                    {
                      "type": "object"
                    },
                    {
                      "type": "array"
                    }
                  ]
                }
              },
              {
                "type": "object",
                "additionalProperties": {
                  "oneOf": [
                    {
                      "type": [
                        "string",
                        "number",
                        "integer",
                        "boolean",
                        "null"
                      ]
                    },
                    {
                      "type": "object"
                    },
                    {
                      "type": "array"
                    }
                  ]
                }
              }
            ]
          },
          "ajax_loader_scale": {
            "oneOf": [
              {
                "type": [
                  "string",
                  "number",
                  "integer",
                  "boolean",
                  "null"
                ]
              },
              {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": [
                        "string",
                        "number",
                        "integer",
                        "boolean",
                        "null"
                      ]
                    },
                    {
                      "type": "object"
                    },
                    {
                      "type": "array"
                    }
                  ]
                }
              },
              {
                "type": "object",
                "additionalProperties": {
                  "oneOf": [
                    {
                      "type": [
                        "string",
                        "number",
                        "integer",
                        "boolean",
                        "null"
       

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

前言

Bricks Carousel 元素的 schema。

基本信息

英文名称：Carousel
中文名称：轮播图
Schema ID：bricks://elements/carousel
Schema 版本：2.3
类型：object
分类：media
Tag：div
内部名称：carousel

设置项

type — 类型 (select)
items — 图片 (image-gallery)
query — 查询 (query)
alignItems — 项目对齐 (align-items)
imageDisable — 隐藏图片 (checkbox)
imageSize — 图片尺寸 (select)
imageLightbox — 链接到灯箱 (checkbox)
imageLightboxSize — 图片尺寸 (select)
lightboxImageClick — 图片点击行为 (select)
lightboxAnimationType — 动画 (select)
lightboxCaption — 标题 (checkbox)
lightboxThumbnails — 缩略图导航 (checkbox)
lightboxThumbnailSize — 缩略图尺寸 (number)
lightboxPadding — 内边距 (dimensions)
_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 文档。