Blocs de composition : Ingrédients, matériaux et constituants

Un bloc de composition est une déclaration structurée de ce dont est composé un produit. Il regroupe les noms des ingrédients, les types de matériaux, les quantités des composants, les pourcentages, les fonctions et les qualificatifs requis afin qu’un acheteur n’ait pas à reconstituer le produit à partir de photographies d’emballage ou de textes marketing.

L’élément sépare le produit et son champ d’application de chaque constituant et de sa valeur. « 65 % de polyester recyclé » n’a de sens que lorsque le lecteur sait s’il décrit le tissu extérieur, la doublure, le rembourrage, le vêtement entier ou l’emballage.

Pourquoi cet élément est important

La composition influence des décisions que les slogans produits ne peuvent pas satisfaire. Un acheteur peut vouloir éviter un allergène, comparer la teneur en laine, vérifier un revêtement, choisir un emballage recyclable mono-matériau ou confirmer la concentration d’un composant actif. Il cherche à savoir si le produit est sûr, adapté, entretenable, conforme à la politique ou qui vaut son prix.

La structure réduit ce coût de décision. « Fabriqué avec du coton, du polyester recyclé et un revêtement protecteur » laisse les lecteurs découvrir à quelle partie chaque matériau appartient et si la liste est complète. Des lignes étiquetées rendent les noms, les valeurs et les omissions faciles à parcourir.

Les moteurs de recherche, les systèmes de comparaison, les agents d’achat, les outils d’accessibilité et les flux produits ont également besoin de conserver la relation entre un constituant, une quantité, une unité, une partie du produit et une variante. Les virgules ne permettent pas de savoir de manière fiable si « coton 35 %, doublure polyester, revêtement polyuréthane » signifie trois pourcentages, deux tissus et une finition, ou un texte incomplet.

Les déclarations réglementées rendent l’ambiguïté plus grave. Les classes de produits contrôlés peuvent avoir des exigences spécifiques au marché concernant le nom, l’ordre, l’emphase, la quantité et la langue. Étant donné que les obligations diffèrent selon le produit et la juridiction, préservez la déclaration approuvée, le marché, la révision et la source ; ne demandez jamais à un rédacteur ou à un moteur de rendu de déduire la conformité. La structure ne rend pas le contenu conforme, mais elle rend les champs obligatoires testables.

Quand l’utiliser

Utilisez un bloc de composition chaque fois que l’identité ou la quantité d’un constituant influence la sélection, l’utilisation sécuritaire, la conformité, la comparaison, l’entretien, le recyclage ou l’approvisionnement. Les applications incluent :

• les déclarations d’ingrédients alimentaires et de boissons, avec mise en évidence des allergènes régie séparément si requis ;
• les noms d’ingrédients cosmétiques dans l’ordre et la nomenclature approuvés ;
• la composition des fibres textiles répartie par tissu extérieur, doublure, rembourrage, garniture ou autre partie pertinente ;
• les matériaux d’ameublement et de construction séparés par couche structurelle ou composant ;
• les mélanges chimiques et composants actifs avec concentrations et base déclarée ;
• les compléments ou produits formulés dont l’identité et la quantité d’ingrédients doivent rester distinctes ;
• la composition de l’emballage utilisée pour l’élimination, le recyclage ou les allégations environnementales ;
• les assemblages techniques où la « composition » désigne une nomenclature limitée de matériaux constitutifs plutôt qu’un catalogue complet de pièces.

Utilisez un bloc pour un champ d’application approuvé. Un matelas peut avoir des groupes nommés pour le revêtement, la couche de confort et le noyau ; différents parfums nécessitent des enregistrements séparés. Chaque ligne doit rester vraie pour le produit, la variante, le marché et la révision nommés en haut.

Les cas proches nécessitent des structures différentes. Les dimensions, la tension, la compatibilité et les performances sont des spécifications. La nutrition décrit les nutriments et une portion de référence, pas nécessairement les ingrédients. Les instructions d’entretien décrivent le comportement après l’achat. Les déclarations d’allergènes séparées nécessitent leur propre traitement approuvé. « Ami de la planète » n’est ni un constituant ni une preuve. Une nomenclature de fabrication peut être trop détaillée ou confidentielle pour les clients.

Les règles d’écriture des éléments priment : sélectionnez l’élément typé en fonction de l’objectif du passage. Si le rôle du bloc est d’identifier en quoi consiste le sujet, utilisez la composition même si un tableau, un accordéon ou un paragraphe générique pourrait en imiter l’apparence.

Où le placer

Placez le bloc principal après l’identité du produit et les informations d’achat, mais avant les allégations, instructions ou conseils qui dépendent de la composition. Il précède normalement l’entretien, la sécurité, la durabilité et les spécifications détaillées. Les exigences réglementaires de placement prévalent sur les préférences éditoriales.

Un résumé compact dans la zone d’achat doit inclure les informations critiques pour la décision et exposer la déclaration complète sans changer de contexte. Conservez le contenu intégral dans la source de la page et accessible sans JavaScript.

Gardez le bloc à côté de son étiquette de champ d’application. Il peut se trouver à côté d’une image ou d’un tableau de spécifications avec des titres clairs. Il ne peut pas se trouver à côté de l’allégation d’une autre variante, d’un badge environnemental non qualifié ou d’un message marketing contradictoire. N’insérez jamais de témoignage, d’offre, de vente croisée ou d’appel à l’action entre le titre de la déclaration et les lignes.

Pour les multipacks, kits et produits configurables, placez chaque article formulé indépendamment dans un sous-groupe étiqueté. Ne faites jamais la moyenne des compositions dans un lot. Sur mobile, préservez l’ordre : sujet et champ d’application, base, constituants, qualificatifs, source ou révision. Les colonnes visuelles peuvent se réduire, mais les relations ne peuvent pas être modifiées.

Anatomie

1. Titre : nomme la déclaration simplement, par exemple « Ingrédients », « Composition des matériaux » ou « Composants actifs ».
2. Identité du sujet : lie le contenu à un produit, une UGS, une variante, une formulation ou un composant exact.
3. Champ d’application : indique le marché, la partie du produit, l’état de préparation, le composant de l’emballage ou toute autre limite déterminant ce que décrivent les lignes.
4. Base de déclaration : explique ce que signifient les quantités, par exemple pourcentage du poids des fibres, milligrammes par comprimé ou grammes pour 100 grammes tel que vendu.
5. Nom du constituant : préserve le nom courant, technique, normalisé ou réglementé approuvé.
6. Quantité : fournit un nombre, une plage, un seuil ou une absence intentionnelle sans supposition.
7. Unité ou proportion : reste attachée à sa quantité et utilise une convention définie au sein d’un groupe.
8. Rôle ou qualificatif : identifie les fonctions, sous-ingrédients, revêtements, supports, auxiliaires technologiques ou exclusions uniquement lorsqu’ils sont approuvés et pertinents.
9. Emphase requise : expose un allergène, un composant actif ou une phrase obligatoire par le texte et le balisage sémantique, pas uniquement par la couleur.
10. Provenance : enregistre la source approuvée, le marché, la révision et la date de révision utilisés pour générer la déclaration.

Exemples de conception

Chaque variante de conception utilise les mêmes enregistrements de constituants sous-jacents. La variante modifie les étiquettes et le regroupement parce que la classe de produit pose une question différente ; elle ne transforme jamais une déclaration vérifiée en texte promotionnel libre.

Ingrédients ordonnés. À utiliser lorsque l’ordre est significatif ou réglementé. Préservez l’ordre source, la ponctuation, les ingrédients imbriqués et l’emphase requise. N’alphabetisez pas pour des raisons esthétiques et ne fusionnez pas deux noms approuvés en une étiquette plus conviviale.

Pourcentages de matériaux par composant. À utiliser pour les textiles, l’ameublement, l’emballage ou les produits en couches. Regroupez par partie physique, indiquez ce que totalisent les pourcentages et distinguez un traitement de surface de la fibre ou du matériau sous-jacent.

Composants actifs et concentrations. À utiliser lorsqu’une substance active ou un constituant fonctionnel doit être quantifié. Gardez la quantité, l’unité, la base et l’état du produit ensemble. Les avertissements de sécurité et les directives restent des éléments séparés régis, même s’ils proviennent de la même source.

Composition technique en couches. À utiliser pour les assemblages tels que les revêtements de sol, l’isolation, les filtres ou les matelas. Représentez la hiérarchie physique explicitement. L’épaisseur peut apparaître comme un qualificatif du constituant, mais les spécifications de performances non liées appartiennent à leur propre tableau.

Comparaison compacte. À utiliser uniquement lorsque deux produits ou plus ont des catégories de constituants véritablement comparables. Affichez « Non déclaré » ou « Sans objet » plutôt qu’une cellule vide. Conservez le bloc complet faisant autorité sur chaque fiche produit ; la comparaison est une vue dérivée, pas une nouvelle source.

Paramètres

« Source » identifie l’endroit où le moteur de rendu obtient chaque champ. L’enregistrement approuvé du produit ou de la réglementation reste faisant autorité ; le corps peut ajouter un contexte explicatif contrôlé mais ne peut pas remplacer les faits liés à la source.

Les valeurs autorisées pour item.flag sont contrôlées par l’implémentation, par exemple allergen, active, restricted ou regulated-name. Un indicateur déclenche une présentation et une validation approuvées ; les auteurs ne peuvent pas utiliser des indicateurs arbitraires pour créer des avertissements ou des badges marketing.

Syntaxe et exemples de code

Les trois formes codent le même enregistrement de tissu extérieur de veste. La directive portable est la représentation canonique rédigée par l’auteur ; un projet doit implémenter et tester les adaptateurs Hugo et WordPress avant de le publier.

Directive Markdown portable

:::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.
:::

Shortcode 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 >}}

Chaque paramètre Hugo est nommé. L’exemple ne mélange pas les paramètres positionnels et nommés.

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]

Un bloc WordPress natif devrait stocker les constituants sous forme d’enregistrements typés répétables, et non comme un seul champ de texte enrichi. Verrouillez les noms et valeurs liés à la source lorsqu’ils proviennent d’un système de gestion des informations produit, tout en permettant à un réviseur autorisé d’approuver une présentation spécifique au marché.

Bons et mauvais exemples

Bon exemple

Composition des matériaux — Veste de travail Harbor HJ-204, tissu extérieur : 65 % polyester recyclé ; 35 % coton biologique. Les pourcentages sont basés sur le poids des fibres du tissu extérieur. Le revêtement en polyuréthane est exclu des pourcentages de fibres. Doublure : 100 % polyester. Source approuvée HJ-204-US, révision 6.

Cela fonctionne parce que cela nomme le produit et les parties exactes, fournit une base pour chaque groupe de pourcentages, distingue le revêtement des fibres et expose la révision approuvée. Les valeurs totalisent dans leur champ d’application déclaré plutôt que de prétendre décrire la veste entière.

Mauvais exemple

Mélange éco premium : Principalement du coton naturel avec des fibres recyclées performantes et une finition protectrice respectueuse de la planète.

Cela échoue parce que « principalement » n’est pas une quantité, « mélange » cache la relation entre les matériaux et « finition » n’a pas d’identité chimique ou de composant. Cela omet le champ d’application tissu extérieur/doublure, fait une allégation environnementale non étayée et ne fournit ni source ni révision. Un acheteur ne peut pas le comparer, et une machine ne peut pas en extraire des constituants défendables.

Balisage schema et accessibilité

Aucun schéma de composition universel ne couvre chaque classe de produit réglementée. Pour un Product authentique, un matériau simple peut correspondre à material de Schema.org. Les faits nommés peuvent parfois être mappés via additionalProperty et PropertyValue, en conservant name, value et unitText ou unitCode ensemble. Des identifiants stables doivent les lier à la variante visible.

Ne forcez pas les déclarations dans des propriétés non liées. Recipe.recipeIngredient décrit une recette, pas l’étiquette d’un produit emballé. N’émettez jamais de pourcentage à partir de l’ordre de la liste et ne transformez pas une inference environnementale ou d’allergène en fait. Générez les flux sectoriels à partir de l’enregistrement approuvé, pas du HTML rendu.

Les données structurées complètent, mais ne remplacent jamais, la déclaration visible. Les machines ne doivent pas recevoir une version plus riche ou d’un champ d’application différent. Si le schéma ne peut pas exprimer une base ou un qualificatif, omettez la propriété et préservez le fait visible.

Utilisez un véritable titre et un conteneur sémantique par déclaration. Les ingrédients ordonnés utilisent des listes ; les enregistrements nom-valeur utilisent des listes de description ou des tableaux avec en-têtes. Les composés imbriqués nécessitent une structure de liste imbriquée. L’ordre du lecteur d’écran doit correspondre à l’ordre approuvé.

Ne comptez jamais uniquement sur le gras, les majuscules, la couleur, les icônes ou les infobulles pour les allergènes ou le statut réglementé. Incluez le texte requis dans le contenu accessible. Les expandeurs nécessitent un bouton, un état précis, un fonctionnement au clavier et un contenu de secours rendu côté serveur. Les unités visibles et accessibles doivent concorder.

Règles d’écriture

Le bloc préserve la vérité exacte du produit, donc la concision ne peut pas justifier l’omission du champ d’application, de la base, des qualificatifs ou des noms requis. Appliquez ces règles après avoir confirmé la source et la politique du marché :

• Titrez le bloc en un à cinq mots. Privilégiez le vocabulaire attendu par les acheteurs et les régulateurs : « Ingrédients », « Composition des matériaux » ou « Composants actifs ».
• Incluez une à 100 lignes. Au-delà, utilisez un regroupement gouverné ou un document approuvé ; ne tronquez jamais silencieusement.
• Limitez les noms à 120 caractères lorsque possible, mais préservez intacts les noms réglementés plus longs.
• Préservez l’ordre requis. Sinon, conservez la séquence approuvée de la fiche produit sur tous les canaux.
• Attachez les quantités aux unités et à une base. Ne forcez jamais des couches incomparables dans un faux total de 100 %.
• Utilisez des chiffres pour les quantités et des symboles d’unité contrôlés. Localisez la présentation des décimales et des unités sans modifier la valeur stockée.
• Distinguez « Non déclaré », « Sans objet », « Quantité non fournie » et zéro ; un blanc est ambigu.
• Limitez les notes à 40 mots après le groupe concerné. Elles clarifient le champ d’application mais ne peuvent pas remplacer les lignes.
• Utilisez un langage factuel et neutre. Gardez les explications séparées des noms légaux ou normalisés.
• Vérifiez la classe de produit, le marché, la langue, la variante et la révision exacts. Revalidez chaque modification pertinente.

Ne placez jamais de prix, de stock, de livraison, de témoignages, d’allégations promotionnelles, d’instructions d’élimination, de posologie, d’avertissements de sécurité, d’informations nutritionnelles complètes ou de spécifications non liées à l’intérieur du bloc de composition. Ces informations peuvent se trouver à proximité dans leurs propres éléments régis. Ne déduisez jamais « sans », hypoallergénique, végétalien, recyclable, naturel, biologique, non toxique ou écologique à partir d’une seule liste de constituants. N’utilisez jamais une photographie d’emballage comme seule déclaration, car son texte peut être illisible, obsolète, spécifique au marché et indisponible pour les technologies d’assistance.

Types de publications qui l’utilisent

Le champ postTypes du frontmatter est la source d’implémentation pour cette matrice.

Liste de contrôle QA

• Le bloc identifie le produit, l’UGS ou la formulation, le marché et le champ d’application physique exacts qu’il décrit.
• La déclaration provient d’une source approuvée, et son ID de source, sa révision et sa date de révision sont conservés.
• Chaque nom de constituant correspond au nom courant, technique, normalisé ou réglementé approuvé.
• Les déclarations ordonnées préservent l’ordre source ; aucun moteur de rendu n’alphabetise, ne fusionne ni ne réordonne les lignes.
• Chaque valeur numérique a une unité et une base visible, et les plages ou seuils conservent leurs opérateurs.
• Les pourcentages totalisent uniquement dans un champ d’application partagé valide ; les couches, revêtements et composants exclus sont identifiés.
• Les états manquant, zéro, sans objet et non déclaré sont représentés comme des états distincts.
• Les ingrédients composés ou matériaux en couches utilisent des groupes imbriqués explicites plutôt qu’une ponctuation ambiguë.
• L’emphase requise pour les allergènes, composants actifs ou réglementaires reste disponible dans le texte et pour les technologies d’assistance.
• Le bloc visible, le flux produit, la source d’emballage, la sortie schema et la sélection de variante ne se contredisent pas mutuellement.
• Aucune ligne de composition ne contient de prix, disponibilité, promotion, témoignage, avantage non étayé ou d’allégation environnementale ou de sécurité inférée.
• La déclaration complète fonctionne sans images, survol, couleur, JavaScript ou mise en page développée pour ordinateur.
• Les modifications de formulation, fournisseur, composant, emballage, juridiction ou révision déclenchent une revalidation.
• Les trois exemples de syntaxe préservent le même sujet, champ d’application, base, lignes, source et révision.

FAQ

Un bloc de composition est-il identique à un tableau de spécifications ?

Non. Un bloc de composition identifie en quoi consiste un produit et, le cas échéant, la quantité ou la proportion de chaque constituant. Un tableau de spécifications décrit des caractéristiques mesurables telles que les dimensions, la capacité, la tension ou la compatibilité. Gardez les deux structures séparées, même lorsqu’elles apparaissent à proximité l’une de l’autre.

Chaque ingrédient doit-il inclure un pourcentage ?

Non. Incluez un pourcentage lorsque la règle en vigueur, la source approuvée ou la décision de l’acheteur l’exige. Ne déduisez jamais un pourcentage de l’ordre de la liste. Préservez l’ordre approuvé des ingrédients et n’indiquez une quantité exacte que lorsque la source fournit une base et une unité valides.

Le marketing peut-il réécrire les noms réglementés d’ingrédients ou de matériaux ?

Non. Les noms affichés peuvent être complétés par une explication en langage simple lorsque la politique le permet, mais le nom légal ou normalisé requis doit rester intact. Le texte marketing ne peut pas remplacer, abréger, réordonner ou atténuer une déclaration réglementée.

Un bloc de composition produit-il automatiquement un balisage schema ?

Non. Certains champs peuvent être mappés aux valeurs Product.material ou additionalProperty, mais il n’existe pas d’objet Schema.org universel pour la composition de chaque classe de produit. Émettez uniquement les propriétés prises en charge qui décrivent avec précision le produit visible et n’utilisez jamais de données structurées comme substitut à la déclaration sur la page.

Comment la composition doit-elle différer entre les variantes de produits ou les marchés ?

Liez le bloc à l’UGS et au marché exacts. Si la couleur, la taille, le parfum, la formule, le fournisseur ou la destination modifie la déclaration, affichez l’enregistrement approuvé correspondant et identifiez son champ d’application. Ne combinez pas plusieurs variantes en une seule liste, sauf si chaque constituant et chaque quantité sont véritablement identiques.