在主题编辑器中调用元对象（仅适用于 OS 3.0 主题）
元对象（Metaobject）是店铺级别的可复用数据记录，可在店铺任意页面的组件中调用，非常适合需要跨商品或跨页面共享的内容，如尺码表、成分库或养护指南。与商品或分类的元字段不同，元对象不依附于特定页面。您还可以为元对象定义创建专属的模板页面，并将元对象条目发布为带有独立 SEO 设置的独立店铺页面。此功能仅适用于 OS 3.0 主题，不支持 OS 2.0 或 OS 2.1 主题。
本文将介绍如何在 OS 3.0 主题编辑器中将元对象条目绑定至组件、使用嵌套元对象引用、真实的应用场景、创建和管理元对象模板页面，以及将元对象条目发布为页面。
|
注意：
|
在 OS 3.0 中调用元对象的前提条件
开始之前，请确认以下条件已满足：
- 您的店铺必须使用 OS 3.0 版本主题。元对象动态源为 OS 3.0 主题编辑器的专属功能。
- 您必须已在管理后台完成元对象定义的创建，并添加至少一个条目。如尚未完成，请先参阅《元对象 (Metaobject) 功能使用指南》，完成后再按照本文步骤操作。
了解元对象作为店铺级别动态源的原理
元对象是您在管理后台创建和管理的独立可复用数据记录。由于元对象存在于店铺层级，不依附于任何特定商品或页面，您可以在店铺任意页面上将其数据调用至支持动态源的组件中。
这使得元对象非常适合需要在多个商品或页面共享的内容，例如：
- 整个服装系列共用的尺码表
- 美妆品牌跨商品引用的成分库
- 同一家具系列下所有商品共用的设计师资料
将元对象条目绑定至主题编辑器组件
在管理后台完成元对象定义和条目的创建后，请按以下步骤在主题编辑器中绑定元对象字段。
如需绑定元对象，请按以下步骤操作：
- 在主题编辑器中，点击您想要绑定数据的区块（例如富文本 section ）。
- 点击内容输入栏旁的【添加动态源】图标。
- 在动态源面板中，选择【元对象（Metaobject）】。
- 在第一级列表中，选择您的元对象类型（即定义名称，例如「成分」或「尺码表」）。
- 在第二级列表中，选择您要展示的具体条目（例如「烟酰胺」或「女装上衣」）。
- 在第三级列表中，选择您要展示的字段（例如「功效」或「尺寸对照表」）。所选字段的值将立即绑定至该组件并实时显示，并点击【保存】。
进阶用法：在 OS 3.0 中使用嵌套元对象引用
OS 3.0 编辑器支持最多两级的元对象嵌套引用。在选择要展示的字段时（「将元对象条目绑定至主题编辑器组件」的第 6 步——即选择具体字段以显示其值），如果该字段本身是对另一个元对象的引用，编辑器将允许您点击进入，继续选取内层元对象的字段。
示例：一个「商品故事」元对象包含一个「摄影师」字段，该字段引用了独立的「团队成员」元对象。您可以通过逐层选取，直接在「商品故事」组件中展示摄影师的姓名或头像。
| 注意：目前最多支持 2 级元对象嵌套引用，超出第二层的字段无法通过主题编辑器访问。 |
管理元对象模板与页面
创建元对象定义与条目后，您可以为其建立专属模板，并将条目发布为独立的店铺页面。本节将说明如何创建和管理元对象模板，以及如何将元对象条目发布为页面。
| 注意：元对象定义必须先发布为网页并在在线商店中启用，才能创建其模板。 |
创建元对象模板页面
元对象模板是专属于某一元对象定义的页面模板，类似商品页面使用商品模板的方式。创建模板后，您可以为该元对象下的条目设计独立的页面布局，例如为每位设计师资料或每张尺码表单独设计页面。
如需创建元对象模板，请按以下步骤操作：
- 在主题编辑器中，打开顶部的页面选择下拉菜单，选择【查看所有元对象】。
- 在展开的子菜单中，选择您要创建模板的元对象定义。此列表会显示店铺中所有已创建的元对象定义。
- 如果该定义尚未创建模板，点击【点击创建默认模板】。SHOPLINE 会自动创建一个以该定义类型命名的默认模板（例如，「设计师」定义会创建一个名为designer.json 的模板文件）。
- 如需为同一定义创建其他模板，打开模板下拉菜单并选择【+ 创建模板】。在【创建模板】弹窗中，输入【模板名称】（最多 25 个字符），并从【基于模板】下拉菜单中选择要参考的现有模板（默认值为【默认模板】），然后点击【创建】。新模板将保存为 {type}.{模板名称}.json，因此您可以为同一元对象维护多个版式，例如精选版式和标准版式。
- 使用顶部工具栏中的条目选择图标（提示文字：「跳转到对应条目」）以不同的元对象条目预览模板，方式类似于使用不同商品预览商品模板。
|
注意：
|
将元对象条目发布为店铺页面
创建元对象模板后，您可以将该元对象定义下的单个条目发布为独立的店铺页面，并为其设置专属的 SEO 信息和 URL。
| 注意：在发布条目为页面之前，您必须先为该元对象定义开启【发布条目为网页】：进入 SHOPLINE 管理后台 >【设置】>【自定义数据】>【元对象】，点击该定义，滚动到页面底部开启【发布条目为网页】。 |
如需将元对象条目发布为页面，请按以下步骤操作：
- 在 SHOPLINE 管理后台中，打开您要发布的元对象条目。
- 开启【将条目发布为页面】选项。
- 使用与其他页面类型相同的 SEO 组件，设置该页面的 SEO 标题和描述。
- 选择该页面的 URL。默认情况下，已发布的元对象页面使用 /pages/{type}/{条目 handle} 路径。
- 从模板下拉菜单中选择该页面使用的元对象模板。如果该定义尚未创建模板，请先在主题编辑器中创建（参见上文「创建元对象模板页面」）。
| 注意：已发布元对象页面的默认 URL 格式为 /pages/{type}/{handle}。虽然该路径以 /pages/ 开头，但它属于元对象页面，并非自定义页面两者的管理和编辑方式是分开的。 |
编辑与移除元对象模板
您可以像编辑其他页面模板一样编辑元对象模板，直接在主题编辑器中添加、移除和配置组件。
| 重要：元对象模板无法在主题编辑器内直接删除。如需移除模板，请通过代码编辑器删除对应文件：进入【SHOPLINE 管理后台】>【在线商店】>【设计】，点击【我的主题】区域的三个点图标，然后选择【编辑代码】。 |
元对象真实使用案例
以下案例展示了不同行业的商家如何利用元对象，实现「一次维护，多处复用」的内容管理。
服饰：共用尺码表
一家服装店创建了「尺码表」元对象，包含类别、图片和尺寸对照表等字段。多款商品共用同一条尺码表条目。当尺寸数据有更新时，只需修改条目一次，变更即自动同步至所有关联商品页面。
美妆保养：成分库
一个护肤品牌创建了「成分」元对象，包含成分名称、功效、描述和科学参考等字段，条目涵盖烟酰胺、玻尿酸和视黄醇等。每个商品页面按需引用相关成分条目，在核心成分区展示结构化信息，数据来源统一管理，无需重复录入。
家具：设计师系列
一家家具零售商创建了「设计师」元对象，包含设计师姓名、头像、简介和设计理念等字段，条目涵盖 Thomas Berg 和 Clara Voss 等设计师。每位设计师旗下的多款商品均引用同一条条目。当设计师更新个人简介或替换头像时，只需修改一次，变更即自动同步至该设计师系列下的所有商品页面。
| 提示：元对象同样适合从其他平台迁移过来的商家，可用于承接原有的自定义数据结构。 |
元对象常见问题
Q 1 元对象能在商品页以外的页面使用吗？
可以。由于元对象是店铺级别的数据源，您可以在任何支持动态源的页面中调用元对象，包括首页、自定义页、商品分类页等。
Q 2 元字段与元对象有什么区别？
元字段是直接附加在某个资源（如商品或分类）上的自定义属性。元对象则是独立的、可复用的数据记录，可在多个商品、页面或组件中引用，类似于一张共享的数据表。当数据属于某个具体商品时，使用元字段；当数据需要跨商品或跨页面复用时，使用元对象。如需了解元字段和动态源维度，请参阅《在 OS 3.0 主题编辑器中配置动态源 (Metafield)》。
Q 3 如何创建元对象定义并添加条目？
元对象的创建与管理方法请参阅《元对象 (Metaobject) 功能使用指南》。完成元对象定义和条目的创建后，再按照本文步骤将其连接至店铺前端。
Q 4 可以在主题编辑器中删除元对象模板吗？
不可以。元对象模板无法在主题编辑器中直接删除，如需删除，请通过代码编辑器移除对应文件。
Q 5 如果在添加条目之前就尝试创建元对象模板，会发生什么？
系统会提示您该模板暂时无法编辑。请先在 SHOPLINE 管理后台为该元对象定义添加至少一个条目，然后返回主题编辑器创建并编辑模板。
Q 6 创建元对象模板是否会影响主题更新？
不会。创建元对象模板使用的是标准的主题编辑器功能，不会将您的主题变为自定义版本，也不会影响您正常接收主题的自动更新。