settings_data.json

settings_data.json 文件根据 settings_schema.json 中包含的设置，保存 theme 的设置值。

例如，您可以使用以下主题设置允许商家选择页面背景颜色：

[
  {
    "name": {
      "en-US": "Colors",
      "zh-CN": "颜色"
    },
    "settings": [
      {
        "type": "color",
        "id": "color_body_bg",
        "label": {
          "en-US": "General background",
          "zh-CN": "常规背景"
        },
        "default": "#FFFFFF"
      }
    ]
  },
  ...
]

这将在 settings_data.json 中添加 color_body_bg 的条目：

{
  "current": {
    "color_body_bg": "#FFFFFF"
  }
}

📘 提示

在此示例中，color_body_bg 的值为 #FFFFFF，这是由默认设置属性决定的。

每当在主题编辑器中更改 color_body_bg 的值时，settings_data.json 都会更新为新值。

位置

settings_data.json 文件位于 theme 的 config 目录下：

└── theme
    ...
    ├── config
        ├── settings_data.json
        ├── settings_presets.json
        └── settings_schema.json
    └── locales

Schema

settings_data.json 文件包含以下父级对象：

对象	描述	是否必填
current	包含主题编辑器中当前保存的所有设置值。	是
metafields	包含可区分当前 theme 技术类型（如插件类型）的主题类型设置值。	否

例如：

{
  "current": {
    "color_body_bg": "#FFFFFF",
    ...
  },
  "metafields": {
    "theme_type": "standard" // 表示该技术方案不是 jQuery
  }
}