Blocchi di Composizione: Ingredienti, Materiali e Costituenti

Un blocco di composizione è una dichiarazione strutturata di cosa costituisce un prodotto. Mantiene insieme nomi di ingredienti, tipi di materiali, quantità di componenti, percentuali, funzioni e qualificatori richiesti, in modo che un acquirente non debba ricostruire il prodotto da fotografie di confezioni o testi promozionali.

L’elemento separa il prodotto e l’ambito da ciascun costituente e valore. «65% poliestere riciclato» ha senso solo quando il lettore sa se descrive il tessuto esterno, la fodera, l’imbottitura, l’intero capo o la confezione.

Perché questo elemento è importante

La composizione influisce su decisioni a cui gli slogan del prodotto non possono rispondere. Un acquirente potrebbe evitare un allergene, confrontare il contenuto di lana, verificare un rivestimento, scegliere una confezione monomateriale riciclabile o confermare la concentrazione di un componente attivo. Potrebbe dover decidere se il prodotto è sicuro, adatto, manutenibile, conforme alle normative o che vale il suo prezzo.

La struttura riduce il costo di quella decisione. «Realizzato con cotone, poliestere riciclato e un rivestimento protettivo» lascia ai lettori il compito di scoprire a quale parte appartiene ciascun materiale e se l’elenco è completo. Righe etichettate rendono facili da scorrere nomi, valori e omissioni.

Anche i motori di ricerca, i sistemi di confronto, gli agenti di acquisto, gli strumenti di accessibilità e i feed di prodotto devono mantenere la relazione tra un costituente, la quantità, l’unità, la parte del prodotto e la variante. Le virgole non possono indicare in modo affidabile se «cotone 35%, fodera poliestere, rivestimento poliuretano» significa tre percentuali, due tessuti e una finitura, o un testo incompleto.

Le dichiarazioni regolamentate rendono l’ambiguità più grave. Le classi di prodotto controllate possono avere requisiti specifici per mercato di denominazione, ordinamento, enfasi, quantità e lingua. Poiché gli obblighi differiscono per prodotto e giurisdizione, preserva la dichiarazione approvata, il mercato, la revisione e la fonte; non chiedere mai a uno scrittore o a un sistema di rendering di dedurre la conformità. La struttura non rende il contenuto conforme, ma rende verificabili i campi obbligatori.

Quando usarlo

Usa un blocco di composizione ogni volta che l’identità o la quantità dei costituenti influenza la selezione, l’uso sicuro, la conformità, il confronto, la cura, il riciclo o l’approvvigionamento. Le applicazioni includono:

• dichiarazioni di ingredienti alimentari e bevande, con enfasi sugli allergeni separatamente regolamentata dove richiesto;
• nomi di ingredienti cosmetici nell’ordine e nella nomenclatura approvati;
• composizione delle fibre tessili suddivisa per tessuto esterno, fodera, imbottitura, guarnizioni o altre parti pertinenti;
• materiali per mobili e edilizia separati per strato strutturale o componente;
• miscele chimiche e componenti attivi con concentrazioni e base dichiarata;
• integratori o prodotti formulati la cui identità e quantità di ingredienti devono rimanere distinte;
• composizione dell’imballaggio utilizzata per smaltimento, riciclo o dichiarazioni ambientali;
• assemblaggi tecnici in cui «composizione» indica un insieme delimitato di materiali costituenti anziché un catalogo completo di parti.

Usa un blocco per un ambito approvato. Un materasso può avere gruppi denominati di rivestimento, strato di comfort e nucleo; gusti diversi necessitano di record separati. Ogni riga deve rimanere valida per il prodotto, la variante, il mercato e la revisione indicati all’inizio.

I casi simili ma diversi necessitano di strutture differenti. Dimensioni, voltaggio, compatibilità e prestazioni sono specifiche. La nutrizione descrive nutrienti e una porzione di riferimento, non necessariamente ingredienti. Le istruzioni per la cura descrivono il comportamento dopo l’acquisto. Dichiarazioni separate sugli allergeni necessitano del proprio trattamento approvato. «Amico del pianeta» non è né un costituente né una prova. Una distinta base di produzione potrebbe essere troppo dettagliata o confidenziale per i clienti.

Le regole di scrittura degli elementi hanno la precedenza: seleziona l’elemento tipizzato in base allo scopo del passaggio. Se il compito del blocco è identificare di cosa è composto il soggetto, usa la composizione anche quando una tabella generica, un accordion o un paragrafo potrebbero imitarne l’aspetto.

Dove posizionarlo

Posiziona il blocco principale dopo l’identità del prodotto e i dati di acquisto, ma prima di dichiarazioni, istruzioni o guide che dipendono dalla composizione. Solitamente precede cura, sicurezza, sostenibilità e specifiche dettagliate. I requisiti normativi di posizionamento prevalgono sulle preferenze editoriali.

Un riepilogo compatto nell’area di acquisto deve includere i dati critici per la decisione ed esporre la dichiarazione completa senza cambiare contesto. Mantieni il contenuto completo nel codice sorgente della pagina e accessibile senza JavaScript.

Mantieni il blocco accanto alla sua etichetta di ambito. Può trovarsi accanto a un’immagine o a una tabella di specifiche con titoli chiari. Non può trovarsi accanto alla dichiarazione di un’altra variante, a un badge ambientale non qualificato o a testi di marketing contraddittori. Non inserire mai una testimonianza, un’offerta, un cross-selling o un CTA tra l’intestazione della dichiarazione e le righe.

Per confezioni multiple, kit e prodotti configurabili, inserisci ogni articolo formulato indipendentemente in un sottogruppo etichettato. Non fare mai la media delle composizioni nell’intera confezione. Su mobile, preserva l’ordine: soggetto e ambito, base, costituenti, qualificatori, fonte o revisione. Le colonne visive possono comprimersi, ma le relazioni no.

Anatomia

1. Titolo: denomina la dichiarazione in modo semplice, ad esempio «Ingredienti», «Composizione dei materiali» o «Componenti attivi».
2. Identità del soggetto: collega il contenuto a un prodotto esatto, SKU, variante, formulazione o componente.
3. Ambito: indica il mercato, la parte del prodotto, lo stato di preparazione, il componente della confezione o altro confine che determina cosa descrivono le righe.
4. Base dichiarativa: spiega cosa significano le quantità, ad esempio percentuale sul peso della fibra, milligrammi per compressa o grammi per 100 grammi tal quale.
5. Nome del costituente: preserva il nome approvato comune, tecnico, standardizzato o regolamentato.
6. Quantità: fornisce un numero, un intervallo, una soglia o uno stato intenzionalmente assente senza fare supposizioni.
7. Unità o proporzione: resta legata alla sua quantità e utilizza una convenzione definita all’interno di un gruppo.
8. Ruolo o qualificatore: identifica funzioni, sotto-ingredienti, rivestimenti, carrier, coadiuvanti tecnologici o esclusioni solo quando approvati e pertinenti.
9. Enfasi richiesta: espone un allergene, un componente attivo o una frase obbligatoria tramite testo e markup semantico, non solo colore.
10. Provenienza: registra la fonte approvata, il mercato, la revisione e la data di revisione utilizzati per generare la dichiarazione.

Esempi di design

Ogni variante di design utilizza gli stessi record di costituenti sottostanti. La variante cambia etichette e raggruppamenti perché la classe di prodotto pone una domanda diversa; non trasforma mai una dichiarazione verificata in testo promozionale libero.

Ingredienti ordinati. Usali quando la sequenza è significativa o regolamentata. Preserva l’ordine della fonte, la punteggiatura, gli ingredienti annidati e l’enfasi richiesta. Non alfabetizzare per ordine visivo né unire due nomi approvati in un’etichetta più amichevole.

Percentuali di materiale per componente. Usale per tessili, mobili, imballaggi o beni a strati. Raggruppa per parte fisica, indica a cosa totalizzano le percentuali all’interno e distingui un trattamento superficiale dalla fibra o materiale sottostante.

Componenti attivi e concentrazioni. Usali quando una sostanza attiva o un costituente funzionale deve essere quantificato. Mantieni insieme quantità, unità, base e stato del prodotto. Avvertenze di sicurezza e istruzioni rimangono elementi separati regolamentati anche quando derivano dalla stessa fonte.

Composizione tecnica a strati. Usala per assemblaggi come pavimentazioni, isolamenti, filtri o materassi. Rappresenta esplicitamente la gerarchia fisica. Lo spessore può apparire come qualificatore del costituente, ma le specifiche prestazionali non correlate appartengono alla propria tabella.

Confronto compatto. Usalo solo quando due o più prodotti hanno categorie di costituenti realmente confrontabili. Mostra «Non dichiarato» o «Non applicabile» anziché una cella vuota. Mantieni il blocco autorevole completo su ciascun record di prodotto; il confronto è una vista derivata, non una nuova fonte.

Parametri

«Fonte» identifica da dove il sistema di rendering ottiene ciascun campo. Il record approvato del prodotto o regolamentare rimane autorevole; il corpo può aggiungere contesto esplicativo controllato ma non può sovrascrivere dati vincolati alla fonte.

I valori consentiti di item.flag sono controllati dall’implementazione, ad esempio allergen, active, restricted o regulated-name. Un flag attiva presentazione e validazione approvate; gli autori non possono utilizzare flag arbitrari per creare avvertenze o badge di marketing.

Sintassi ed esempi di codice

Tutte e tre le forme codificano lo stesso record del tessuto esterno della giacca. La direttiva portabile è la rappresentazione canonica autoriale; un progetto deve implementare e testare gli adapter Hugo e WordPress prima di pubblicarla.

Direttiva Markdown portabile

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

Ogni parametro Hugo è nominato. L’esempio non mescola parametri posizionali e nominati.

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 blocco nativo di WordPress dovrebbe memorizzare i costituenti come record tipizzati ripetibili, non come un unico campo di testo ricco. Blocca i nomi e i valori vincolati alla fonte quando provengono da un sistema di gestione delle informazioni di prodotto, consentendo comunque a un revisore autorizzato di approvare la presentazione specifica per mercato.

Esempi buoni e cattivi

Buono

Composizione dei materiali — Giacca da lavoro Harbor HJ-204, tessuto esterno: 65% poliestere riciclato; 35% cotone organico. Le percentuali sono sul peso della fibra del tessuto esterno. Il rivestimento in poliuretano è escluso dalle percentuali delle fibre. Fodera: 100% poliestere. Fonte approvata HJ-204-US, revisione 6.

Funziona perché indica il prodotto e le parti esatte, fornisce una base per ciascun gruppo di percentuali, distingue il rivestimento dalle fibre ed espone la revisione approvata. I valori totalizzano all’interno del loro ambito dichiarato anziché pretendere di descrivere l’intera giacca.

Cattivo

Miscela eco premium: Per lo più cotone naturale con fibre riciclate ad alte prestazioni e una finitura protettiva amica del pianeta.

Non funziona perché «per lo più» non è una quantità, «miscela» nasconde la relazione tra i materiali e «finitura» non ha un’identità chimica o di componente. Omette l’ambito tessuto esterno versus fodera, fa un’affermazione ambientale non supportata e non fornisce né fonte né revisione. Un acquirente non può confrontarlo e una macchina non può estrarre costituenti difendibili.

Markup schema e accessibilità

Nessuno schema di composizione universale copre ogni classe di prodotto regolamentata. Per un Product genuino, un materiale semplice può essere mappato a material di Schema.org. I dati nominati possono talvolta essere mappati tramite additionalProperty e PropertyValue, mantenendo insieme name, value e unitText o unitCode. Identificativi stabili devono vincolarli alla variante visibile.

Non forzare le dichiarazioni in proprietà non correlate. Recipe.recipeIngredient descrive una ricetta, non l’etichetta di un prodotto confezionato. Non emettere mai una percentuale dall’ordine dell’elenco né trasformare un’inferenza ambientale o su allergeni in un dato di fatto. Genera i feed di settore dal record approvato, non dall’HTML renderizzato.

I dati strutturati integrano, mai sostituiscono, la dichiarazione visibile. Le macchine non devono ricevere una versione più ricca o con ambito diverso. Se schema non può esprimere una base o un qualificatore, ometti la proprietà e preserva il dato visibile.

Usa un’intestazione reale e un contenitore semantico per dichiarazione. Gli ingredienti ordinati usano elenchi; i record nome-valore usano elenchi di definizione o tabelle con intestazioni. I composti annidati necessitano di struttura di elenco annidata. L’ordine per lo screen reader deve corrispondere all’ordine approvato.

Non affidarti mai esclusivamente a grassetto, maiuscolo, colore, icone o tooltip per allergeni o stato regolamentato. Includi il testo richiesto nei contenuti accessibili. Gli expander necessitano di un pulsante, stato accurato, operatività da tastiera e fallback renderizzato lato server. Le unità visibili e accessibili devono concordare.

Regole di scrittura

Il blocco preserva la verità esatta del prodotto, quindi la brevità non può giustificare l’omissione di ambito, base, qualificatori o nomi richiesti. Applica queste regole dopo aver confermato la fonte e la policy di mercato:

• Intitola il blocco in una o cinque parole. Preferisci il vocabolario che acquirenti e regolatori si aspettano: «Ingredienti», «Composizione dei materiali» o «Componenti attivi».
• Includi da una a 100 righe. Oltre, usa un raggruppamento governato o un documento approvato; non troncare mai silenziosamente.
• Mantieni i nomi entro 120 caratteri dove possibile, ma preserva intatti i nomi regolamentati più lunghi.
• Preserva l’ordine richiesto. In caso contrario, mantieni la sequenza del record di prodotto approvato su tutti i canali.
• Associa le quantità alle unità e a una base. Non forzare mai strati non confrontabili in un falso totale del 100%.
• Usa numeri per le quantità e simboli di unità controllati. Localizza la presentazione di decimali e unità senza modificare il valore memorizzato.
• Distingui «Non dichiarato», «Non applicabile», «Quantità non fornita» e zero; un campo vuoto è ambiguo.
• Mantieni le note entro 40 parole dopo il gruppo interessato. Chiariscono l’ambito ma non possono sovrascrivere le righe.
• Usa un linguaggio fattuale e neutro. Mantieni le spiegazioni separate dai nomi legali o standardizzati.
• Verifica la classe di prodotto esatta, il mercato, la lingua, la variante e la revisione. Ricontrolla ogni modifica rilevante.

Non inserire mai prezzo, scorte, consegna, testimonianze, dichiarazioni promozionali, istruzioni per lo smaltimento, indicazioni di dosaggio, avvertenze di sicurezza, dati nutrizionali completi o specifiche non correlate all’interno del blocco di composizione. Questi dati possono trovarsi nelle vicinanze nei propri elementi governati. Non dedurre mai «senza», ipoallergenico, vegano, riciclabile, naturale, biologico, non tossico o ambientalmente preferibile da un semplice elenco di costituenti. Non usare mai una fotografia della confezione come unica dichiarazione, perché il suo testo potrebbe essere illeggibile, obsoleto, specifico per mercato e non disponibile per le tecnologie assistive.

Tipi di post che lo utilizzano

Il campo postTypes nel frontmatter è la fonte di implementazione per questa matrice.

Checklist QA

• Il blocco identifica il prodotto esatto, SKU o formulazione, mercato e ambito fisico che descrive.
• La dichiarazione proviene da una fonte approvata e il suo ID fonte, revisione e data di revisione sono conservati.
• Ogni nome di costituente corrisponde al nome approvato comune, tecnico, standardizzato o regolamentato.
• Le dichiarazioni ordinate preservano l’ordine della fonte; nessun sistema di rendering alfabetizza, unisce o riordina le righe.
• Ogni valore numerico ha un’unità e una base visibile, e intervalli o soglie mantengono i loro operatori.
• Le percentuali totalizzano solo all’interno di un ambito condiviso valido; strati esclusi, rivestimenti e componenti sono identificati.
• Mancante, zero, non applicabile e non dichiarato sono rappresentati come stati distinti.
• Ingredienti composti o materiali a strati utilizzano gruppi annidati espliciti anziché punteggiatura ambigua.
• L’enfasi richiesta su allergeni, componenti attivi o requisiti normativi rimane disponibile nel testo e per le tecnologie assistive.
• Il blocco visibile, il feed prodotto, la fonte dell’imballaggio, l’output schema e la selezione della variante non si contraddicono a vicenda.
• Nessuna riga di composizione contiene prezzo, disponibilità, promozione, testimonianza, beneficio non supportato o dichiarazioni ambientali o di sicurezza inferite.
• La dichiarazione completa funziona senza immagini, hover, colore, JavaScript o layout desktop espanso.
• Modifiche a formulazione, fornitore, componente, imballaggio, giurisdizione o revisione attivano una nuova validazione.
• I tre esempi di sintassi preservano lo stesso soggetto, ambito, base, righe, fonte e revisione.

FAQ

Un blocco di composizione è uguale a una tabella di specifiche?

No. Un blocco di composizione identifica di cosa è composto un prodotto e, ove rilevante, la quantità o proporzione di ciascun costituente. Una tabella di specifiche descrive caratteristiche misurabili come dimensioni, capacità, voltaggio o compatibilità. Mantieni separate le due strutture anche quando appaiono vicine tra loro.

Ogni ingrediente deve includere una percentuale?

No. Includi una percentuale quando la norma applicabile, la fonte approvata o la decisione dell’acquirente lo richiedono. Non dedurre mai una percentuale dall’ordine dell’elenco. Preserva l’ordine approvato degli ingredienti e mostra un importo esatto solo quando la fonte fornisce una base e un’unità valide.

Il marketing può riscrivere i nomi regolamentati di ingredienti o materiali?

No. I nomi visualizzati possono essere integrati con una spiegazione in linguaggio semplice quando la policy lo consente, ma il nome legale o standardizzato richiesto deve rimanere intatto. Il copy di marketing non può sostituire, abbreviare, riordinare o attenuare una dichiarazione regolamentata.

Un blocco di composizione produce automaticamente markup schema?

No. Alcuni campi possono essere mappati a Product.material o additionalProperty, ma non esiste un oggetto Schema.org di composizione universale per ogni classe di prodotto. Emetti solo proprietà supportate che descrivano accuratamente il prodotto visibile e non utilizzare mai dati strutturati come sostituti della dichiarazione sulla pagina.

Come dovrebbe differire la composizione tra varianti di prodotto o mercati?

Associa il blocco allo SKU e al mercato esatti. Se colore, dimensione, gusto, formula, fornitore o destinazione modificano la dichiarazione, mostra il record approvato corrispondente e identifica il suo ambito. Non combinare più varianti in un unico elenco a meno che ogni costituente e quantità non sia realmente identico.