構成ブロック：原材料、材料、成分

構成ブロックとは、製品が何から構成されているかを構造的に宣言するものです。原材料名、材料タイプ、コンポーネント数量、パーセンテージ、機能、必要な限定条件をひとまとめにすることで、購入者がパッケージの写真やマーケティング用の文章から製品を再構成する必要がなくなります。

この要素は、製品と範囲を各構成要素と値から分離します。「リサイクルポリエステル65%」は、それが表地、裏地、中綿、製品全体、またはパッケージのいずれを説明しているかを読者が知っていて初めて意味を持ちます。

この要素が重要な理由

構成は、製品のスローガンでは答えられない判断に影響を与えます。買い物客はアレルゲンを避けたり、ウール含有率を比較したり、コーティングを確認したり、リサイクル可能なモノマテリアルパッケージを選んだり、有効成分の濃度を確認したりするかもしれません。製品が安全か、適切か、維持可能か、ポリシーに準拠しているか、価格に見合うかを判断しているのです。

構造化によって、その判断コストは削減されます。「コットン、リサイクルポリエステル、保護コーティングを使用」とだけ書かれていれば、読者は各素材がどの部分に属しているか、リストが完全かどうかを自分で調べる必要があります。ラベル付きの行は、名前、値、省略事項を一目で確認できるようにします。

検索エンジン、比較システム、ショッピングエージェント、アクセシビリティツール、製品フィードも、構成要素、数量、単位、製品部位、バリエーションの関係性を保持する必要があります。「コットン35%、ポリエステル裏地、ポリウレタンコーティング」が3つのパーセンテージを意味するのか、2つの素材と仕上げを意味するのか、それとも不完全なコピーなのかをカンマは確実に示すことができません。

規制対象の宣言では、曖昧さはさらに深刻になります。管理対象の製品クラスには、市場固有の命名、順序、強調表示、数量、言語の要件がある場合があります。義務は製品と管轄区域によって異なるため、承認された宣言、市場、リビジョン、ソースを保持してください。ライターやレンダラーにコンプライアンスを推測させることは絶対にしないでください。構造化はコンテンツをコンプライアンス対応にするわけではありませんが、必要なフィールドをテスト可能にします。

使用すべきタイミング

構成ブロックは、構成要素の識別や量が、選択、安全な使用、コンプライアンス、比較、手入れ、リサイクル、調達に影響を与える場合に使用します。適用例は以下の通りです：

• 食品・飲料の原材料表示（該当する場合、別途規定されたアレルゲンの強調表示を含む）
• 承認された順序と命名法による化粧品成分名
• 表地、裏地、中綿、トリム、その他該当部分に分けた繊維組成
• 構造層またはコンポーネントごとに分けた家具および建築材料
• 濃度と宣言基準を含む化学混合物および有効成分
• 成分の識別と量を明確に区別する必要があるサプリメントまたは調合製品
• 廃棄、リサイクル、環境主張に使用するパッケージ構成
• 「構成」が完全な部品カタログではなく、構成材料の範囲指定された部品表を意味する技術的アセンブリ

1つの承認範囲につき1つのブロックを使用します。マットレスには、カバー、快適層、コアの各グループに名前が付けられている場合があり、異なるフレーバーには別々のレコードが必要です。すべての行は、上部に記載された製品、バリエーション、市場、リビジョンに対して真実でなければなりません。

類似していても異なる構造が必要なケースもあります。寸法、電圧、互換性、性能は仕様です。栄養成分表示は栄養素と1食分の基準を説明するもので、必ずしも原材料ではありません。お手入れ方法は購入後の行動を説明します。アレルゲンに関する個別の声明は、それぞれ承認された処理が必要です。「環境に優しい」は構成要素でも証拠でもありません。製造部品表は、顧客にとって詳細すぎる、または機密情報を含む場合があります。

要素作成ルール が優先されます：文章の目的に応じて型指定された要素を選択してください。ブロックの役割が「主題が何で構成されているかを特定する」ことである場合は、汎用テーブル、アコーディオン、段落で外観を模倣できる場合でも、構成ブロックを使用してください。

配置場所

主要ブロックは、製品の識別情報と購入情報の後、構成に依存する主張、説明書、ガイダンスの前に配置します。通常は、お手入れ、安全性、持続可能性、詳細仕様の前に置きます。規制による配置要件は、編集上の優先順位に優先します。

コンパクトな購入領域のサマリーには、判断に重要な情報を含め、完全な宣言をコンテキストを変更せずに表示できるようにする必要があります。完全なコンテンツはページソース内に保持し、JavaScriptなしで到達可能にしてください。

ブロックはその範囲ラベルの隣に配置します。画像や仕様表の隣に、明確な見出しを付けて配置しても構いません。別のバリエーションの主張、無条件の環境バッジ、矛盾するマーケティング文言の隣に配置してはいけません。宣言の見出しと行の間に、推薦文、オファー、クロスセル、CTAを挿入しないでください。

マルチパック、キット、設定可能な製品については、個別に調合された各アイテムをラベル付きのサブグループに入れてください。バンドル全体で構成を平均化しないでください。モバイルでは、主題と範囲、基準、構成要素、限定条件、出典またはリビジョンの順序を維持してください。視覚的な列は折りたたまれても構いませんが、関係性は変更してはいけません。

構成要素

1. タイトル： 「原材料」「材料構成」「有効成分」など、宣言内容を平易に示します。
2. 主題の識別情報： 正確な製品、SKU、バリエーション、処方、またはコンポーネントにコンテンツをバインドします。
3. 範囲： 行が何を説明するかを決定する、市場、製品部位、準備状態、パッケージコンポーネント、その他の境界を明記します。
4. 宣言基準： 数量の意味（例：繊維重量に対するパーセンテージ、1錠あたりのミリグラム、販売時の100グラムあたりのグラム数）を説明します。
5. 構成要素名： 承認された一般名、技術名、標準名、または規制名を維持します。
6. 量： 数値、範囲、しきい値、または意図的に不在の状態を、推測なしで提供します。
7. 単位または割合： その量に紐づけられ、グループ内で1つの定義された表記法を使用します。
8. 役割または限定条件： 承認され関連性がある場合にのみ、機能、副原材料、コーティング、キャリア、加工助剤、除外事項を特定します。
9. 必要な強調表示： アレルゲン、有効成分、または義務付けられた文言を、色だけでなくテキストとセマンティックマークアップで示します。
10. 出典： 宣言のレンダリングに使用された承認済み情報源、市場、リビジョン、レビュー日を記録します。

デザイン例

すべてのデザインバリアントは、同じ基礎となる構成要素レコードを使用します。バリアントはラベルとグループ化が変わるのは、製品クラスが異なる質問をするためであり、検証済みの宣言を自由形式のプロモーションコピーに変えることは決してありません。

順序付けられた原材料。 順序が意味を持つ、または規制されている場合に使用します。情報源の順序、句読点、入れ子になった原材料、必要な強調表示を維持してください。見た目の整列のためにアルファベット順にしたり、2つの承認済み名称を1つの親しみやすいラベルに統合したりしないでください。

コンポーネント別の材料パーセンテージ。 繊維製品、家具、パッケージ、または層状製品に使用します。物理的な部位ごとにグループ化し、パーセンテージが何に対して合計されるかを明記し、表面処理と基材の繊維または材料を区別してください。

有効成分と濃度。 有効物質または機能性構成要素を定量化する必要がある場合に使用します。量、単位、基準、製品状態をまとめて維持してください。安全警告と使用上の注意は、同じソースに由来する場合でも、別々の管理された要素として残します。

層状技術構成。 フローリング、断熱材、フィルター、マットレスなどのアセンブリに使用します。物理的な階層を明示的に表現してください。厚さは構成要素の限定条件として表示される場合がありますが、無関係な性能仕様はそれぞれの専用テーブルに属します。

コンパクト比較。 2つ以上の製品が本当に比較可能な構成要素カテゴリを持つ場合にのみ使用してください。空のセルではなく「未宣言」または「該当なし」を表示します。完全な権威あるブロックは各製品レコードに保持してください。比較は派生ビューであり、新しい情報源ではありません。

パラメータ

「ソース」は、レンダラーが各フィールドをどこから取得するかを識別します。承認された製品レコードまたは規制レコードが権威ある情報源となります。本文は管理された説明コンテキストを追加できますが、ソースにバインドされた事実を上書きすることはできません。

許可されるitem.flagの値は実装によって制御され、例えばallergen（アレルゲン）、active（有効成分）、restricted（制限物質）、regulated-name（規制名称）などがあります。フラグは承認された表示と検証をトリガーします。作成者は任意のフラグを使用して警告やマーケティングバッジを作成することはできません。

構文とコード例

3つの形式すべてが同じジャケット表地のレコードをエンコードします。ポータブルディレクティブが正規の作成者表現です。プロジェクトは公開前に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ショートコード

{{< 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ブロックは、構成要素を1つのリッチテキストフィールドとしてではなく、反復可能な型指定レコードとして保存する必要があります。製品情報管理システムから取得したソースバウンドの名前と値はロックし、権限のあるレビューアが市場固有の表示を承認できるようにします。

良い例と悪い例

良い例

材料構成 — Harborワークジャケット HJ-204、表地： リサイクルポリエステル65%、オーガニックコットン35%。パーセンテージは表地の繊維重量比です。ポリウレタンコーティングは繊維含有率から除外されています。裏地：ポリエステル100%。承認済みソースHJ-204-US、リビジョン6。

これが有効な理由は、正確な製品と部位を指定し、各パーセンテージグループの基準を提供し、コーティングを繊維から区別し、承認されたリビジョンを明示しているからです。値は宣言された範囲内で合計し、ジャケット全体を説明しているふりをしていません。

悪い例

プレミアムエコブレンド： 天然コットンをベースに、リサイクル性能繊維と環境に優しい保護仕上げをプラス。

これが失敗する理由は、「ほとんど」は量ではなく、「ブレンド」は素材間の関係を隠し、「仕上げ」には化学的または成分としての識別性がないからです。表地対裏地の範囲が省略され、根拠のない環境主張を行い、出典やリビジョンも示されていません。購入者は比較できず、機械は防御可能な構成要素を抽出できません。

スキーママークアップとアクセシビリティ

すべての規制対象製品クラスをカバーする汎用的な構成スキーマは存在しません。実際のProductについては、単純な材料はSchema.orgのmaterialにマッピングできる場合があります。名前付きの情報は、additionalPropertyとPropertyValueを通じてマッピングし、name、value、unitTextまたはunitCodeをまとめて保持できます。安定した識別子は、それらを表示されているバリエーションにバインドする必要があります。

宣言を無関係なプロパティに強制しないでください。Recipe.recipeIngredientはレシピを説明するものであり、パッケージ製品のラベルではありません。リストの順序からパーセンテージを生成したり、環境またはアレルゲンに関する推測を事実にしたりしないでください。承認されたレコードからセクターフィードを生成し、レンダリングされたHTMLから生成しないでください。

構造化データは、表示される宣言を補完するものであり、決して置き換えるものではありません。機械はよりリッチな、または異なる範囲のバージョンを受け取ってはいけません。スキーマが基準や限定条件を表現できない場合は、そのプロパティを省略し、表示されている事実を維持してください。

宣言ごとに実際の見出しと1つのセマンティックコンテナを使用します。順序付けられた原材料にはリストを、名前と値のレコードには説明リストまたはヘッダー付きテーブルを使用します。入れ子になった複合成分には、入れ子になったリスト構造が必要です。スクリーンリーダーの順序は承認された順序と一致する必要があります。

アレルゲンや規制ステータスについて、太字、大文字、色、アイコン、ツールチップのみに依存しないでください。必要なテキストはアクセシブルなコンテンツに含めてください。展開/折りたたみ要素には、ボタン、正確な状態、キーボード操作、サーバーサイドレンダリングのフォールバックが必要です。表示される単位とアクセシブルな単位は一致している必要があります。

作成ルール

ブロックは正確な製品の真実を保持するため、簡潔さを理由に範囲、基準、限定条件、必要な名称を省略することはできません。情報源と市場ポリシーを確認した上で、以下のルールを適用してください：

• ブロックのタイトルは1～5語にします。購入者や規制当局が期待する語彙（「原材料」「材料構成」「有効成分」）を優先してください。
• 1～100行を含めます。それを超える場合は、管理されたグループ化または承認されたドキュメントを使用し、黙って切り詰めないでください。
• 名前は可能な限り120文字以内に抑えますが、より長い規制名称はそのまま維持してください。
• 必要な順序を維持します。それ以外の場合は、承認された製品レコードの順序をチャネル間で保持します。
• 量には単位と基準を必ず付けてください。比較不可能な層を誤った100%合計に強制しないでください。
• 数量には数字と管理対象の単位記号を使用します。保存された値を変更せずに、小数点と単位の表示をローカライズします。
• 「未宣言」「該当なし」「数量未提供」「ゼロ」を区別してください。空白は曖昧です。
• メモは該当グループの後に40語以内で記述します。範囲を明確にするためのものであり、行を上書きすることはできません。
• 事実に基づいた中立的な言葉を使用します。説明は法的または標準化された名称から分離してください。
• 正確な製品クラス、市場、言語、バリエーション、リビジョンを確認します。関連する変更があるたびに再検証してください。

価格、在庫、配送、推薦文、プロモーションの主張、廃棄手順、用法用量、安全警告、完全な栄養成分表示、または無関係な仕様を構成ブロック内に決して入れないでください。これらの情報は、それぞれの管理された要素として近くに配置されることがあります。「フリーフロム」、低アレルギー性、ビーガン、リサイクル可能、天然、オーガニック、無毒、環境に優しいなどを構成要素リストのみから推測しないでください。パッケージの写真を唯一の宣言として使用しないでください。そのテキストは読み取れない、古い、市場固有、または支援技術で利用できない可能性があります。

使用する投稿タイプ

postTypesフロントマターフィールドが、このマトリックスの実装ソースです。

QAチェックリスト

• ブロックが説明する正確な製品、SKUまたは処方、市場、物理的範囲を特定している。
• 宣言が承認された情報源からのものであり、そのソースID、リビジョン、レビュー日が保持されている。
• すべての構成要素名が承認された一般名、技術名、標準名、または規制名と一致している。
• 順序付けられた宣言はソースの順序を維持しており、レンダラーが行をアルファベット順に並べ替えたり、統合したり、並べ替えたりしていない。
• すべての数値に単位と表示された基準があり、範囲やしきい値はその演算子を保持している。
• パーセンテージは有効な共有範囲内でのみ合計されており、除外された層、コーティング、コンポーネントが特定されている。
• 欠損、ゼロ、該当なし、未宣言が別個の状態として表現されている。
• 複合原材料や層状材料は、曖昧な句読点ではなく、明示的な入れ子グループを使用している。
• 必要なアレルゲン、有効成分、または規制上の強調表示がテキストおよび支援技術で利用可能である。
• 表示されるブロック、製品フィード、パッケージソース、スキーマ出力、バリエーション選択が互いに矛盾していない。
• 構成行に価格、在庫状況、プロモーション、推薦文、根拠のないベネフィット、または推測された環境・安全性の主張が含まれていない。
• 完全な宣言が画像、ホバー、色、JavaScript、拡大デスクトップレイアウトなしで機能する。
• 処方、サプライヤー、コンポーネント、パッケージ、管轄区域、またはリビジョンの変更が再検証をトリガーする。
• 3つの構文例が同じ主題、範囲、基準、行、ソース、リビジョンを保持している。

FAQ

構成ブロックは仕様表と同じですか？

いいえ。構成ブロックは製品の構成要素と、該当する場合は各構成要素の量や割合を特定します。仕様表は、寸法、容量、電圧、互換性などの測定可能な特性を説明します。互いに近くに配置される場合でも、2つの構造は分けて維持してください。

すべての原材料にパーセンテージを含める必要がありますか？

いいえ。該当する規則、承認された情報源、または購入者の判断に必要な場合にのみパーセンテージを含めてください。リストの順序からパーセンテージを推測しないでください。承認された原材料の順序を維持し、情報源が有効な基準と単位を提供する場合にのみ正確な量を表示してください。

マーケティング部門が規制対象の原材料名や材料名を書き換えることはできますか？

いいえ。ポリシーで許可されている場合、表示名に平易な説明を補足することはできますが、必要な法定名または標準名はそのまま維持しなければなりません。マーケティングコピーは、規制対象の宣言を置き換え、省略、並べ替え、または弱めることはできません。

構成ブロックは自動的にスキーママークアップを生成しますか？

いいえ。一部のフィールドはProduct.materialやadditionalPropertyの値にマッピングできますが、すべての製品クラスに適用される汎用的なSchema.org構成オブジェクトは存在しません。表示されている製品を正確に説明するサポート対象プロパティのみを出力し、構造化データをページ上の宣言の代わりとして使用しないでください。

製品バリエーションや市場によって構成はどのように異なるべきですか？

ブロックを正確なSKUと市場にバインドします。色、サイズ、フレーバー、処方、サプライヤー、または販売先によって宣言内容が変わる場合は、一致する承認済みレコードをレンダリングし、その範囲を特定してください。すべての構成要素と量が本当に同一でない限り、複数のバリエーションを1つのリストに結合しないでください。