组合成分块:成分、材料和构成
构建一个组合成分块,清晰结构化展示成分、材料、数量和受管制的产品事实,供买家、搜索引擎和AI代理使用。
组合成分块是一种产品由什么组成的结构化声明。它将成分名称、材料类型、组件数量、百分比、功能和必需的限定条件整合在一起,使买家无需从产品包装照片或营销文案中重新拼凑产品信息。
材料组成
产品: Harbor 工装夹克,面料,款式 HJ-204
- 再生聚酯纤维
- 纤维重量的65%
- 有机棉
- 纤维重量的35%
- 涂层
- 聚氨酯;不计入纤维百分比
声明依据:仅面料。内衬:100% 聚酯纤维。来源:已批准产品记录 HJ-204-US,第6版。
该元素将产品和范围与每种成分和数值分离。“65% 再生聚酯纤维"只有在读者知道它描述的是面料、内衬、填充物、整件服装还是包装时才有意义。
为什么这个元素很重要
产品组成影响产品口号无法回答的决策。购物者可能希望避开过敏原、比较羊毛含量、检查涂层、选择可回收的单材料包装,或确认活性成分的浓度。他们可能正在决定产品是否安全、合适、可维护、符合政策或物有所值。
结构化降低了这种决策成本。“由棉、再生聚酯纤维和保护性涂层制成"这样的描述让读者自己去发现每种材料属于哪个部分以及列表是否完整。带标签的行使名称、数值和遗漏项易于扫描。
搜索引擎、对比系统、购物代理、无障碍工具和产品信息流也需要保留成分、数量、单位、产品部分和变体之间的关系。逗号无法可靠地表明"棉35%、聚酯纤维内衬、聚氨酯涂层"是指三个百分比、两种面料加一种表面处理,还是不完整的文案。
受管制的声明使模糊性问题更加严重。受控产品类别可能有针对特定市场的命名、排序、强调、数量和语言要求。由于不同产品和司法管辖区的义务各不相同,请保留已批准的声明、市场、修订版本和来源;切勿让作者或渲染器推断合规性。结构本身不会使内容合规,但它使必填字段可被检验。
何时使用
当成分身份或数量影响选择、安全使用、合规性、比较、保养、回收或采购时,使用组合成分块。应用场景包括:
- 食品和饮料成分声明,在需要时对过敏原进行单独规定的强调;
- 化妆品成分名称,按照批准的次序和命名法排列;
- 纺织纤维成分,按面料、内衬、填充物、装饰或其他相关部分拆分;
- 家具和建筑材料,按结构层或组件分隔;
- 化学混合物和活性成分,附有浓度和声明的依据;
- 补充剂或配方产品,其成分身份和数量必须保持明确;
- 用于处置、回收或环保声明的包装成分;
- 技术组件,“成分"指限定范围内的构成材料清单,而非完整的零部件目录。
每个已批准的范围使用一个块。一张床垫可能有命名的表面层、舒适层和芯层组;不同口味需要单独的记录。每行必须对顶部命名的产品、变体、市场和修订版本保持真实。
近似情况需要使用不同的结构。尺寸、电压、兼容性和性能属于规格参数。营养成分描述营养素和每份基准,不一定是成分。护理说明描述购买后的行为。单独的过敏原声明需要各自批准的处理方式。“环保友好"既不是成分也不是证据。制造物料清单可能过于详细或对客户保密。
元素写作规则 具有优先权:根据段落的用途选择类型化元素。如果该块的功能是识别主题由什么组成,即使通用表格、折叠面板或段落可以模仿其外观,也应使用成分组合块。
放置位置
将主要块放置在产品身份和购买事实之后,但在依赖成分的声明、说明或指导之前。它通常位于护理、安全、可持续性和详细规格之前。法规放置要求优先于编辑偏好。
紧凑的购买区域摘要必须包含决策关键事实,并展示完整的声明而不改变上下文。将完整内容保留在页面源代码中,且无需JavaScript即可访问。
将该块保持在其范围标签旁边。它可以位于图像或规格表旁边,并带有清晰的标题。它不能位于其他变体的声明、无条件的环保标识或矛盾营销文案旁边。切勿在声明标题和行之间插入推荐语、优惠、交叉销售或行动号召按钮。
对于多件装、套件和可配置产品,将每个独立配方产品放在带标签的子组中。切勿对整个组合的成分进行平均计算。在移动端上保留顺序:主题和范围、依据、成分、限定条件、来源或修订版本。视觉列可以折叠,但关系不能改变。
结构
- 标题: 如实命名声明,例如"成分”、“材料组成"或"活性成分”。
- 主体身份: 将内容绑定到确切的产品、SKU、变体、配方或组件。
- 范围: 说明市场、产品部位、制备状态、包装组件或其他界定行描述内容范围的边界。
- 声明依据: 解释数量含义,例如纤维重量百分比、每片剂毫克数或每100克产品销售时的克数。
- 成分名称: 保留已批准的通用、技术、标准化或受管制名称。
- 数量: 提供数字、范围、阈值或有意留空的状态,不做猜测。
- 单位或比例: 与其数量保持关联,并在组内使用统一的约定。
- 作用或限定词: 仅在已批准且相关时标识功能、子成分、涂层、载体、加工助剂或排除项。
- 必需强调: 通过文本和语义标记(而非仅靠颜色)展示过敏原、活性成分或强制措辞。
- 来源记录: 记录用于呈现声明的已批准来源、市场、修订版本和审核日期。
设计示例
每种设计变体使用相同的基础成分记录。变体更改标签和分组是因为产品类别提出不同的问题;它绝不会将经过验证的声明转化为自由的促销文案。
有序成分列表。 当顺序有意义或受法规要求时使用。保留源顺序、标点、嵌套成分和必需强调。不要为了视觉整洁而按字母排序,也不要将两个已批准名称合并成一个更友好的标签。
按组件的材料百分比。 用于纺织品、家具、包装或分层商品。按物理部分分组,说明百分比在组内总和情况,并将表面处理与底层纤维或材料区分开来。
活性成分和浓度。 当需要量化活性物质或功能成分时使用。将数量、单位、依据和产品状态保持在一起。安全警告和使用说明即使来自同一来源,也仍然是单独的有规制的元素。
分层技术组成。 用于地板、隔热材料、过滤器或床垫等装配件。明确表示物理层次结构。厚度可以作为成分限定词出现,但不相关的性能规格应放在自己的表格中。
紧凑对比。 仅当两个或多个产品具有真正可比的成分类别时使用。显示"未声明"或"不适用"而非空单元格。在每个产品记录上保留完整的权威块;对比视图是派生视图,而非新的来源。
参数
“来源"标识渲染器获取每个字段的位置。已批准的产品或法规记录保持权威性;正文可以添加受控的解释性上下文,但不能覆盖源头绑定的事实。
| 名称 | 类型 | 必需 | 最小/最大 | 默认值 | 来源 |
|---|---|---|---|---|---|
| title | 纯文本字符串 | 否 | 1–5个词 | Composition | 正文中的第一个标题 |
| subject | 产品或组件标识符 | 是 | 1个值;1–80个字符 | 所属页面产品 | 属性 |
| variant | SKU或配方标识符 | 有条件 | 1个精确值;1–64个字符 | 所属产品 | 属性 |
| market | 受控市场或司法管辖区代码 | 受管制内容必填 | 1–8个代码 | 站点市场 | 属性 |
| scope | 纯文本字符串或受控组件ID | 是 | 1–8个组;每组1–50个字符 | whole-product | 属性 |
| basis | 受控字符串 | 有数量时必需 | 每组1个;2–12个词 | 无 | 属性 |
| ordered | 布尔值 | 否 | true 或 false | false | 属性 |
| items | 成分记录 | 是 | 1–100行 | 无 | 正文 |
| item.name | 已批准的普通或标准化名称 | 是 | 1–120个字符 | 无 | 正文 |
| item.amount | 小数、范围、阈值或空值 | 有条件 | 0或以上;1个值 | 未声明 | 正文 |
| item.unit | 受控单位或百分比 | 有数量时必需 | 1个单位 | 从basis继承 | 正文 |
| item.role | 受控或已批准的纯文本字符串 | 否 | 1–6个词 | 无 | 正文 |
| item.flag | 枚举列表 | 否 | 0–4个值 | 无 | 正文 |
| revision | 纯文本标识符 | 受管制内容必填 | 1个值;1–40个字符 | 无 | 属性 |
| reviewed | ISO 8601日期 | 受管制内容必填 | 1个日期 | 无 | 属性 |
| source | 已批准的系统或文档ID | 是 | 1–3个值 | 无 | 属性 |
| note | 纯文本 | 否 | 0–40个词 | 无 | 正文 |
允许的 item.flag 值由实现控制,例如 allergen、active、restricted 或 regulated-name。标志触发已批准的呈现和验证;作者不能使用任意标志创建警告或营销徽章。
语法和代码示例
以下三种形式都编码相同的夹克面料记录。便携式指令是规范的创作者表示形式;项目在发布前必须实现并测试 Hugo 和 WordPress 适配器。
便携式 Markdown 指令
:::composition{subject="Harbor work jacket" variant="HJ-204" market="US" scope="shell" basis="percent by fiber weight" source="pim:H-J204-US" revision="6" reviewed="2026-08-20"}
## Material composition
- name: Recycled polyester
amount: 65
unit: "%"
- name: Organic cotton
amount: 35
unit: "%"
Note: Polyurethane coating is excluded from fiber percentages. Lining is declared separately.
:::
Hugo shortcode
{{< composition subject="Harbor work jacket" variant="HJ-204" market="US" scope="shell" basis="percent by fiber weight" source="pim:H-J204-US" revision="6" reviewed="2026-08-20" >}}
## Material composition
- name: Recycled polyester
amount: 65
unit: "%"
- name: Organic cotton
amount: 35
unit: "%"
Note: Polyurethane coating is excluded from fiber percentages. Lining is declared separately.
{{< /composition >}}
每个 Hugo 参数都是命名参数。该示例不混合位置参数和命名参数。
WordPress
[composition subject="Harbor work jacket" variant="HJ-204" market="US" scope="shell" basis="percent by fiber weight" source="pim:H-J204-US" revision="6" reviewed="2026-08-20"]
<h2>Material composition</h2>
<ul>
<li data-name="Recycled polyester" data-amount="65" data-unit="percent">Recycled polyester: 65%</li>
<li data-name="Organic cotton" data-amount="35" data-unit="percent">Organic cotton: 35%</li>
</ul>
<p>Polyurethane coating is excluded from fiber percentages. Lining is declared separately.</p>
[/composition]
原生 WordPress 块应将成分存储为可重复的类型化记录,而非单一富文本字段。当名称和值来自产品信息管理系统时,锁定源头绑定的名称和值,同时允许经授权的审核者批准特定市场的呈现方式。
好与坏的示例
好的示例
材料组成 — Harbor 工装夹克 HJ-204,面料: 65% 再生聚酯纤维;35% 有机棉。百分比按面料纤维重量计算。聚氨酯涂层不计入纤维百分比。内衬:100% 聚酯纤维。已批准来源 HJ-204-US,第6版。
这之所以成立,是因为它命名了确切的产品和部件,为每个百分比组提供了依据,区分了涂层和纤维,并展示了已批准的修订版本。数值在其声明的范围内加总,而非假装描述整件夹克。
差的示例
优质环保混纺: 主要为天然棉,搭配再生功能性纤维和环保友好型保护性表面处理。
这之所以失败,是因为"主要"不是数量,“混纺"掩盖了材料之间的关系,“表面处理"没有化学成分或组件身份标识。它省略了面料与内衬的范围,做出了未经证实的环保声明,且未提供来源或修订版本。买家无法进行比较,机器也无法提取可辩护的成分。
结构化数据和无障碍性
没有通用的成分组合模式涵盖所有受管制的产品类别。对于真正的 Product,简单的材料可以映射到 Schema.org 的 material。命名事实有时可以通过 additionalProperty 和 PropertyValue 映射,将 name、value 和 unitText 或 unitCode 保持在一起。稳定的标识符必须将它们绑定到可见的变体。
不要将声明强制放入不相关的属性中。Recipe.recipeIngredient 描述的是食谱,而非包装产品标签。切勿根据列表顺序推断百分比,也不要把环境或过敏原推断转变为事实。从已批准的记录生成行业信息流,而非渲染后的 HTML。
结构化数据补充但绝不替代可见的声明。机器不得接收更丰富或范围不同的版本。如果结构化数据无法表达依据或限定词,则省略该属性并保留可见的事实。
每个声明使用一个真实的标题和一个语义容器。有序成分使用列表;名称-值记录使用描述列表或带标题的表格。嵌套复合物需要嵌套列表结构。屏幕阅读器顺序必须与已批准的顺序一致。
切勿仅依靠加粗、大写、颜色、图标或工具提示来标识过敏原或受管制状态。在可访问内容中包含必需的文本。展开器需要按钮、准确的状态、键盘操作和服务器端渲染的备选方案。可见单位与无障碍单位必须一致。
写作规则
该块保留确切的产品真相,因此简洁性不能成为省略范围、依据、限定词或必需名称的理由。在确认来源和市场政策后应用以下规则:
- 用一个到五个词命名该块。优先使用买家和监管机构预期的词汇:“成分”、“材料组成"或"活性成分”。
- 包含1到100行。超出此范围时,使用受控分组或已批准的文件;切勿静默截断。
- 名称尽可能保持在120个字符以内,但保留更长的受管制名称的完整性。
- 保留必需的顺序。否则在所有渠道保持已批准的产品记录顺序。
- 将数量与单位和依据关联。切勿将不可比较的层次强行纳入虚假的100%总和。
- 数量使用数字和受控单位符号。本地化小数和单位呈现方式,但不改变存储的值。
- 区分"未声明”、“不适用”、“未提供数量"和零;空白是有歧义的。
- 在受影响的组之后,注释保持在40个词以内。它们澄清范围但不能覆盖行内容。
- 使用事实性、中立的语言。将解释与法律或标准化名称分开。
- 审查确切的产品类别、市场、语言、变体和修订版本。每次相关更改后重新验证。
切勿将价格、库存、配送、推荐语、促销声明、处置说明、剂量指导、安全警告、完整营养成分或不相关的规格放入组合成分块内。这些事实可以位于附近的各自有规制的元素中。切勿仅从成分列表中推断"不含”、“低致敏”、“纯素”、“可回收”、“天然”、“有机”、“无毒"或"环保优选"等声明。切勿将包装照片作为唯一的声明来源,因为其文本可能无法读取、过时、针对特定市场且对辅助技术不可用。
使用该元素的内容类型
postTypes 前置元数据字段是此矩阵的实现源。
| 内容类型 | 作用 | 放置位置 | 必需的调整 |
|---|---|---|---|
| 产品页面 | 对客户的权威声明 | 在身份和购买事实之后,在依赖的声明或说明之前 | 绑定到确切的SKU、市场、范围和已批准的修订版本 |
| 分类页面 | 筛选或紧凑对比事实 | 仅在数值已标准化时放入筛选器或产品摘要中 | 在产品记录上保留完整声明,并展示缺失状态 |
| 购买指南 | 决策标准 | 在解释某种材料或成分为何重要之后 | 引用当前有来源依据的事实,但不暗示仅凭成分就能保证安全或质量 |
| 对比页面 | 同类成分对比 | 在共享标准部分内 | 对齐范围和依据;切勿将整体产品值与单个组件进行比较 |
| 评测页面 | 支持分析的已验证产品事实 | 在相关发现或产品事实部分附近 | 将制造商声明与测试过程中得出的观察结果分开 |
| 标准或法规页面 | 受影响声明的示例 | 在定义范围和义务之后 | 标注司法管辖区、生效版本、例外情况和权威来源 |
| 代理产品数据 | 机器可操作的成分记录 | 在确切产品或变体实体内部 | 展示类型化名称、值、单位、依据、范围、来源记录和修订版本 |
QA 检查清单
- 该块标识了其描述的确切产品、SKU或配方、市场和物理范围。
- 声明来自已批准来源,且其来源ID、修订版本和审核日期已保留。
- 每个成分名称与已批准的通用、技术、标准化或受管制名称匹配。
- 有序声明保留源顺序;任何渲染器不得按字母排序、合并或重新排序各行。
- 每个数值都有单位并附有可见依据,范围或阈值保留其运算符。
- 百分比仅在有效的共享范围内加总;被排除的层、涂层和组件已标识。
- 缺失、零、不适用和未声明以不同状态表示。
- 复合成分或分层材料使用明确的嵌套组,而非模糊的标点符号。
- 必需的过敏原、活性成分或受管制强调在文本中及对辅助技术仍然可用。
- 可见块、产品信息流、包装来源、结构化数据输出和变体选择互不矛盾。
- 没有成分行包含价格、可用性、促销、推荐语、未经支持的好处或推断的环境/安全声明。
- 完整声明在没有图像、悬停、颜色、JavaScript或展开的桌面布局的情况下即可使用。
- 配方、供应商、组件、包装、司法管辖区或修订版本的更改触发重新验证。
- 三个语法示例保持相同的主体、范围、依据、行、来源和修订版本。
常见问题
组合成分块和规格表是一样的吗?
不一样。组合成分块标识产品由什么组成,并在相关时标明每种成分的数量或比例。规格表描述可衡量的特性,如尺寸、容量、电压或兼容性。即使两者位置相近,也应保持结构分离。
每种成分都必须包含百分比吗?
不。当适用规则、批准来源或买家决策有要求时才包含百分比。切勿根据列表顺序推断百分比。保留已批准的成分顺序,仅在来源提供有效依据和单位时才显示准确数量。
营销文案可以改写受管制的成分或材料名称吗?
不。如果政策允许,显示名称可以补充通俗的解释,但必须保持所需的法律或标准化名称完整。营销文案不得替换、缩写、重新排序或弱化受管制的声明。
组合成分块会自动生成结构化数据标记吗?
不。某些字段可以映射到 Product.material 或 additionalProperty 值,但不存在适用于所有产品类别的通用 Schema.org 组合对象。仅输出能够准确描述可见产品的受支持属性,切勿使用结构化数据替代页面上的声明。
不同产品变体或市场的成分组成应如何区别?
将块绑定到确切的SKU和市场。如果颜色、尺寸、口味、配方、供应商或目标市场的不同导致声明发生变化,则渲染匹配的已批准记录并标识其适用范围。除非每种成分和数量确实完全一致,否则不要将多个变体合并到同一列表中。
准备好付诸实践了吗?
免费检查 · 7天试用 · 无需信用卡