Shopify 主题与 Liquid

Shopify 报 Setting type 无效怎么改类型

现象#

给 section 加了一个下拉框,schema 里写 type 为 dropdown,保存时提示设置类型必须属于允许列表,整组设置都没有出现。

原因#

  • 设置类型是固定枚举,dropdown 不在列表里,下拉框对应的类型是 select
  • 旧教程里的部分类型已调整或下线,照抄会直接校验失败
  • 命名风格不匹配,例如写成 image-picker 而不是 image_picker
  • 类型本身合法但缺少必填项,select 没有 options、range 没有 min 和 max

处理步骤#

  1. 对照官方 section schema 的类型表,把 dropdown 改为 select
  2. 为 select 补 options,每项包含 value 与 label
  3. 图片选择用 image_picker,颜色用 color,开关用 checkbox
  4. range 必须同时给 min、max、step、default
  5. 保存后在编辑器里逐项操作,确认值能写进 section.settings

验收标准#

报错消失,编辑器出现下拉框;选中某一项后前台输出对应的 value,切换选项内容随之变化。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。