在 OS 3.0 主题编辑器中配置动态源 (Metafield)

三大动态资源解析

OS 3.0 主题编辑器采用了一套通用的底层机制，适用于所有 OS 3.0 主题（包括官方、第三方及自定义主题）与组件。根据组件在页面中所处位置的不同，系统提供以下三种数据抓取逻辑，以满足多样化的展示需求：

当前页面资源 

• 运作逻辑： 这是一种固定的数据逻辑，完全由消费者当前访问的「页面网址 (URL)」决定。
• 应用场景： 适用于商品详情页或商品分类页的固定位置。
• 效果： 当消费者访问 A 商品页时，系统自动识别 URL 并锁定 A 商品的元字段。组件只要连接至「当前商品」，即可自动抓取该页面的专属资料。

当前组件资源

• 运作逻辑： 基于「组件自身层级」的设定，不依赖所在页面。组件层级配置了什么数据，底下的模块就会读取什么数据。
• 应用场景： 适用于可放置在任意页面（如首页）的独立组件，如「特色推荐商品」section。
• 效果： 商家必须先在组件的最高层级手动绑定一个资源（如：夏季促销分类）。绑定后，内部模块选择「当前组件」，即可精准抓取该分类资料，避免因找不到源头而显示空白。

最近资源

• 运作逻辑： 采用「由下往上逐层寻找」的逻辑。section 会从当前结构出发，向上寻找离它最近的一层有效数据源并套用。
• 应用场景： 主要用于商品列表页或搜索结果页。
• 效果： 解决了列表页卡片无法识别循环中「单一商品」数据的痛点。卡片内的元素（如标题、图片）只要设定为「最近资源」，就会自动匹配列表赋予它的该项商品数据。

理解与使用「最近资源」

最近资源机制是实现自动化布局的核心突破。在处理大量商品展示时，最近资源能确保每个商品卡片都能精准展示对应的独特属性（如：饮料的酒精含量或服装的面料构成）。

为什么使用最近资源

• 自动化： 您无需再为商品中的每个独立卡片手动分配数据。
• 精细化展示： 直接在列表或搜索结果的产品卡片上展示特定属性（例如：饮料的酒精含量或衣服的面料类型）。

如何配置最近资源

1. 在 OS 3.0 主题编辑器 中，前往包含商品列表的页面（例如：商品详情页）。
2. 选中商品详情模板内的某个 block（例如：商品描述 block）。
   
3. 点击旁边的【添加动态源】图标。
   
4. 在【最近资源】分类下选择【最近商品】。
5. 选择您想要展示的具体【元字段】并点击【保存】。

使用场景：产品列表 vs. 独立组件

选择正确的资源维度取决于组件在页面中的应用方式：

• 场景一：商品列表页
  • 应用位置： 位于商品列表页或搜索结果页的商品。
  • 配置方式： 为商品卡片内的模块选择【最近资源】。
  • 效果： 这能确保商品中的每一张卡片都能自动匹配其对应的商品特性，实现批量展示。
• 场景二：在任意页面添加商品展示分区 
  • 应用位置： 当您在首页或自定义页面上添加「特色推荐商品」或「商品列表」等 section。
  • 配置方式： 您必须先在组件层级 (Section Level) 手动指定一个固定的数据源（例如绑定「夏季新品」分类）。
  • 效果： 允许您在非商品模板页面上，精准展示特定范围的商品动态信息，实现更灵活的店铺布局。