Blok zloženia: Zložky, materiály a zložky produktu

Blok zloženia je štruktúrované vyhlásenie o tom, z čoho sa produkt skladá. Udržiava názvy zložiek, typy materiálov, množstvá komponentov, percentá, funkcie a požadované kvalifikátory pohromade, aby kupujúci nemusel rekonštruovať produkt z fotografií balenia alebo marketingových textov.

Prvok oddeľuje produkt a rozsah od každej zložky a hodnoty. „65 % recyklovaného polyesteru“ má význam len vtedy, keď čitateľ vie, či opisuje vrchný materiál, podšívku, výplň, celý odev alebo balenie.

Prečo na tomto prvku záleží

Zloženie ovplyvňuje rozhodnutia, na ktoré produktové slogany nevedia odpovedať. Nakupujúci sa môže chcieť vyhnúť alergénu, porovnať obsah vlny, skontrolovať povrchovú úpravu, vybrať recyklovateľný monomateriálový obal alebo potvrdiť koncentráciu účinnej zložky. Môže sa rozhodovať, či je produkt bezpečný, vhodný, udržiavateľný, v súlade s predpismi alebo hodný svojej ceny.

Štruktúra znižuje náklady na toto rozhodovanie. „Vyrobené z bavlny, recyklovaného polyesteru a ochrannej povrchovej úpravy“ necháva čitateľa zisťovať, do ktorej časti každý materiál patrí a či je zoznam úplný. Označené riadky robia názvy, hodnoty a vynechania ľahko skenovateľnými.

Vyhľadávače, porovnávacie systémy, nákupní agenti, nástroje pre prístupnosť a produktové feedy tiež potrebujú zachovať vzťah medzi zložkou, množstvom, jednotkou, časťou produktu a variantom. Čiarky nedokážu spoľahlivo určiť, či „bavlna 35 %, polyesterová podšívka, polyuretánom upravené“ znamená tri percentá, dve textílie a povrchovú úpravu alebo neúplný text.

Regulované vyhlásenia robia nejednoznačnosť vážnejšou. Kontrolované triedy produktov môžu mať požiadavky na názvoslovie, poradie, dôraz, množstvo a jazyk špecifické pre daný trh. Keďže povinnosti sa líšia podľa produktu a jurisdikcie, zachovajte schválené vyhlásenie, trh, revíziu a zdroj; nikdy nežiadajte autora ani renderer, aby odvodzoval súlad so predpismi. Štruktúra nerobí obsah záväzným, ale robí požadované polia testovateľnými.

Kedy ho použiť

Blok zloženia použite vždy, keď identita alebo množstvo zložky ovplyvňuje výber, bezpečné používanie, súlad s predpismi, porovnanie, starostlivosť, recykláciu alebo obstarávanie. Medzi aplikácie patrí:

• deklarácie zložiek potravín a nápojov, s osobitne riadeným zvýraznením alergénov tam, kde sa vyžaduje;
• názvy kozmetických zložiek v schválenom poradí a názvosloví;
• textilné zloženie vlákien rozdelené na vrchný materiál, podšívku, výplň, lemovanie alebo inú relevantnú časť;
• materiály nábytku a stavebníctva rozdelené podľa konštrukčnej vrstvy alebo komponentu;
• chemické zmesi a účinné zložky s koncentráciami a deklarovaným základom;
• doplnky alebo formulované produkty, pri ktorých musí zostať identita a množstvo zložky odlišné;
• zloženie obalu používané na likvidáciu, recykláciu alebo environmentálne tvrdenia;
• technické zostavy, kde „zloženie“ znamená ohraničený zoznam materiálov, nie úplný katalóg dielov.

Použite jeden blok pre jeden schválený rozsah. Matrac môže mať pomenované skupiny poťahu, komfortnej vrstvy a jadra; rôzne príchute potrebujú samostatné záznamy. Každý riadok musí byť pravdivý pre produkt, variant, trh a revíziu uvedenú v záhlaví.

Blízke prípady potrebujú iné štruktúry. Rozmery, napätie, kompatibilita a výkon sú špecifikácie. Výživové údaje opisujú živiny a referenčnú dávku, nie nevyhnutne zložky. Návody na starostlivosť opisujú správanie po kúpe. Samostatné vyhlásenia o alergénoch potrebujú vlastné schválené spracovanie. „Ekologický“ nie je zložka ani dôkaz. Výrobný kusovník môže byť pre zákazníkov príliš podrobný alebo dôverný.

Pravidlá písania prvkov majú prednosť: vyberte typovaný prvok podľa účelu pasáže. Ak je úlohou bloku identifikovať, z čoho sa predmet skladá, použite zloženie, aj keď by jeho vzhľad mohla napodobniť všeobecná tabuľka, akordeón alebo odsek.

Kam ho umiestniť

Primárny blok umiestnite po identite produktu a nákupných faktoch, ale pred tvrdeniami, pokynmi alebo usmerneniami, ktoré závisia od zloženia. Zvyčajne predchádza starostlivosti, bezpečnosti, udržateľnosti a podrobným špecifikáciám. Regulačné požiadavky na umiestnenie majú prednosť pred redakčnými preferenciami.

Stručný súhrn v nákupnej oblasti musí obsahovať rozhodujúce fakty a sprístupniť úplné vyhlásenie bez zmeny kontextu. Udržujte celý obsah v zdroji stránky a dosiahnuteľný bez JavaScriptu.

Blok udržiavajte vedľa jeho označenia rozsahu. Môže byť vedľa obrázka alebo tabuľky špecifikácií s jasnými nadpismi. Nemôže byť vedľa tvrdenia iného variantu, nekvalifikovaného environmentálneho označenia alebo protirečivého marketingu. Nikdy nevkladajte medzi nadpis vyhlásenia a riadky svedectvo, ponuku, krížový predaj ani CTA.

Pri multipakoch, setoch a konfigurovateľných produktoch umiestnite každú samostatne formulovanú položku do označenej podskupiny. Nikdy nespriemerujte zloženie v rámci balenia. Na mobile zachovajte poradie: subjekt a rozsah, základ, zložky, kvalifikátory, zdroj alebo revíziu. Vizuálne stĺpce sa môžu zrútiť, ale vzťahy nie.

Anatómia

1. Názov: pomenúva vyhlásenie jednoducho, napríklad „Zložky“, „Materiálové zloženie“ alebo „Účinné zložky“.
2. Identita subjektu: viaže obsah na presný produkt, SKU, variant, formuláciu alebo komponent.
3. Rozsah: uvádza trh, časť produktu, stav prípravy, súčasť balenia alebo inú hranicu, ktorá určuje, čo riadky opisujú.
4. Základ vyhlásenia: vysvetľuje, čo množstvá znamenajú, napríklad percento hmotnosti vlákien, miligramy na tabletu alebo gramy na 100 gramov v predajnom stave.
5. Názov zložky: zachováva schválený bežný, technický, štandardizovaný alebo regulovaný názov.
6. Množstvo: uvádza číslo, rozsah, hranicu alebo zámerne neuvedený stav bez dohadovania.
7. Jednotka alebo podiel: zostáva pripojená k svojmu množstvu a používa jednu definovanú konvenciu v rámci skupiny.
8. Funkcia alebo kvalifikátor: identifikuje funkcie, podzložky, povrchové úpravy, nosiče, pomocné látky alebo vylúčenia len vtedy, keď sú schválené a relevantné.
9. Požadované zvýraznenie: sprístupňuje alergén, účinnú zložku alebo nariadenú frázu prostredníctvom textu a sémantického značenia, nie len farby.
10. Pôvod: zaznamenáva schválený zdroj, trh, revíziu a dátum kontroly použité na vykreslenie vyhlásenia.

Príklady dizajnu

Každá varianta dizajnu používa rovnaké základné záznamy zložiek. Varianta mení označenia a zoskupenie, pretože trieda produktu kladie inú otázku; nikdy nemení overené vyhlásenie na voľný propagačný text.

Zoradené zložky. Použite, keď je poradie zmysluplné alebo regulované. Zachovajte poradie zdroja, interpunkciu, vnorené zložky a požadované zvýraznenie. Nezoraďujte abecedne kvôli vizuálnej úhľadnosti a nespájajte dva schválené názvy do priateľskejšieho označenia.

Materiálové percentá podľa komponentu. Použite pre textílie, nábytok, obaly alebo vrstvené výrobky. Zoskupte podľa fyzickej časti, uveďte, v rámci čoho sa percentá sčítavajú, a odlíšte povrchovú úpravu od základného vlákna alebo materiálu.

Účinné zložky a koncentrácie. Použite, keď je potrebné kvantifikovať účinnú látku alebo funkčnú zložku. Udržujte množstvo, jednotku, základ a stav produktu pohromade. Bezpečnostné varovania a pokyny zostávajú samostatnými riadenými prvkami, aj keď pochádzajú z rovnakého zdroja.

Vrstvené technické zloženie. Použite pre zostavy, ako sú podlahy, izolácie, filtre alebo matrace. Reprezentujte fyzickú hierarchiu explicitne. Hrúbka sa môže objaviť ako kvalifikátor zložky, ale nesúvisiace výkonnostné špecifikácie patria do vlastnej tabuľky.

Kompaktné porovnanie. Použite len vtedy, keď majú dva alebo viac produktov skutočne porovnateľné kategórie zložiek. Namiesto prázdnej bunky zobrazte „Neuvádza sa“ alebo „Neuplatňuje sa“. Úplný autoritatívny blok uchovávajte v zázname každého produktu; porovnanie je odvodený pohľad, nie nový zdroj.

Parametre

„Zdroj“ identifikuje, odkiaľ renderer získava každé pole. Schválený produktový alebo regulačný záznam zostáva autoritatívny; telo môže pridať kontrolovaný vysvetľujúci kontext, ale nesmie prepísať fakty viazané na zdroj.

Povolené hodnoty item.flag sú riadené implementáciou, napríklad allergen, active, restricted alebo regulated-name. Príznak spúšťa schválenú prezentáciu a validáciu; autori nemôžu používať ľubovoľné príznaky na vytváranie varovaní alebo marketingových odznakov.

Syntax a príklady kódu

Všetky tri formy kódujú rovnaký záznam vrchného materiálu bundy. Prenosná direktíva je kanonická autorská reprezentácia; projekt musí implementovať a otestovať adaptéry pre Hugo a WordPress pred jeho publikovaním.

Prenosná Markdown direktíva

:::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"}
## Materiálové zloženie

- name: Recycled polyester
  amount: 65
  unit: "%"
- name: Organic cotton
  amount: 35
  unit: "%"

Poznámka: Polyuretánová povrchová úprava je vylúčená z percentuálnych podielov vlákien. Podšívka je deklarovaná samostatne.
:::

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" >}}
## Materiálové zloženie

- name: Recycled polyester
  amount: 65
  unit: "%"
- name: Organic cotton
  amount: 35
  unit: "%"

Poznámka: Polyuretánová povrchová úprava je vylúčená z percentuálnych podielov vlákien. Podšívka je deklarovaná samostatne.
{{< /composition >}}

Každý Hugo parameter je pomenovaný. Príklad nemieša pozičné a pomenované parametre.

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>Materiálové zloženie</h2>
<ul>
  <li data-name="Recycled polyester" data-amount="65" data-unit="percent">Recyklovaný polyester: 65 %</li>
  <li data-name="Organic cotton" data-amount="35" data-unit="percent">Organická bavlna: 35 %</li>
</ul>
<p>Polyuretánová povrchová úprava je vylúčená z percentuálnych podielov vlákien. Podšívka je deklarovaná samostatne.</p>
[/composition]

Natívny WordPress blok by mal ukladať zložky ako opakovateľné typované záznamy, nie ako jedno pole s bohatým textom. Uzamknite názvy a hodnoty viazané na zdroj, keď pochádzajú zo systému správy produktových informácií, a zároveň umožnite autorizovanému recenzentovi schváliť prezentáciu špecifickú pre daný trh.

Dobré a zlé príklady

Dobrý príklad

Materiálové zloženie — Pracovná bunda Harbor HJ-204, vrchný materiál: 65 % recyklovaného polyesteru; 35 % organickej bavlny. Percentá sú podľa hmotnosti vlákien vrchného materiálu. Polyuretánová povrchová úprava je vylúčená z percentuálnych podielov vlákien. Podšívka: 100 % polyester. Schválený zdroj HJ-204-US, revízia 6.

Toto funguje, pretože uvádza presný produkt a časti, poskytuje základ pre každú percentuálnu skupinu, odlišuje povrchovú úpravu od vlákien a uvádza schválenú revíziu. Hodnoty sa sčítavajú v rámci svojho deklarovaného rozsahu, namiesto toho, aby predstierali, že opisujú celú bundu.

Zlý príklad

Prémiová eko zmes: Prevažne prírodná bavlna s recyklovanými výkonnostnými vláknami a ekologickou ochrannou povrchovou úpravou.

Toto zlyháva, pretože „prevažne“ nie je množstvo, „zmes“ skrýva vzťah medzi materiálmi a „úprava“ nemá chemickú identitu ani identitu komponentu. Chýba rozsah vrchný materiál verzus podšívka, obsahuje nepodložené environmentálne tvrdenie a neuvádza zdroj ani revíziu. Kupujúci to nemôže porovnať a stroj z toho nedokáže extrahovať obhájiteľné zložky.

Značkovanie schémy a prístupnosť

Neexistuje univerzálna schéma zloženia, ktorá by pokrývala každú regulovanú triedu produktov. Pre skutočný Product sa jednoduchý materiál môže mapovať na Schema.org material. Pomenované fakty sa niekedy dajú mapovať pomocou additionalProperty a PropertyValue, pričom name, value a unitText alebo unitCode zostávajú spolu. Stabilné identifikátory ich musia viazať na viditeľný variant.

Nenúťte vyhlásenia do nesúvisiacich vlastností. Recipe.recipeIngredient opisuje recept, nie etiketu baleného produktu. Nikdy nevytvárajte percento z poradia v zozname a nemenite environmentálny ani alergénový odhad na fakt. Generujte sektorové feedy zo schváleného záznamu, nie z vykresleného HTML.

Štruktúrované dáta dopĺňajú, nikdy nenahrádzajú viditeľné vyhlásenie. Stroje nesmú dostať bohatšiu alebo inak rozsahovo vymedzenú verziu. Ak schéma nedokáže vyjadriť základ alebo kvalifikátor, vynechajte vlastnosť a zachovajte viditeľný fakt.

Použite skutočný nadhad a jeden sémantický kontajner na vyhlásenie. Zoradené zložky používajú zoznamy; záznamy názov-hodnota používajú opisné zoznamy alebo tabuľky s hlavičkami. Vnorené zlúčeniny potrebujú vnorenú štruktúru zoznamu. Poradie pre čítačku obrazovky musí zodpovedať schválenému poradiu.

Nikdy sa nespoliehajte len na tučné písmo, veľké písmená, farbu, ikony alebo tooltipy pre alergény alebo regulovaný stav. Zahrňte požadovaný text do prístupného obsahu. Rozbaľovače potrebujú tlačidlo, presný stav, ovládanie klávesnicou a fallback vykreslený na serveri. Viditeľné a prístupné jednotky sa musia zhodovať.

Pravidlá písania

Blok zachováva presnú pravdu o produkte, takže stručnosť nemôže ospravedlniť vynechanie rozsahu, základu, kvalifikátorov alebo požadovaných názvov. Tieto pravidlá aplikujte po potvrdení zdroja a trhovej politiky:

• Blok pomenujte jedným až piatimi slovami. Uprednostnite slovnú zásobu, ktorú očakávajú kupujúci a regulátori: „Zložky“, „Materiálové zloženie“ alebo „Účinné zložky“.
• Zahrňte jeden až 100 riadkov. Nad tento počet použite riadené zoskupenie alebo schválený dokument; nikdy ticho neorezávajte.
• Názvy udržujte na maximálne 120 znakov, ak je to možné, ale dlhšie regulované názvy zachovajte v pôvodnom znení.
• Zachovajte požadované poradie. Inak dodržte schválenú postupnosť produktového záznamu naprieč kanálmi.
• Pripojte množstvá k jednotkám a základu. Nikdy nenúťte neporovnateľné vrstvy do falošného 100 % súčtu.
• Používajte číslice pre množstvá a kontrolované symboly jednotiek. Lokalizujte desatinné miesta a jednotky bez zmeny uloženej hodnoty.
• Rozlišujte medzi „Neuvádza sa“, „Neuplatňuje sa“, „Množstvo neuvedené“ a nulou; prázdne miesto je nejednoznačné.
• Poznámky udržujte na 40 slov po dotknutej skupine. Objasňujú rozsah, ale nemôžu prepísať riadky.
• Používajte faktický, neutrálny jazyk. Vysvetlenia udržiavajte oddelené od právnych alebo štandardizovaných názvov.
• Skontrolujte presnú triedu produktu, trh, jazyk, variant a revíziu. Opätovne validujte každú relevantnú zmenu.

Nikdy nevkladajte cenu, skladovú dostupnosť, doručenie, svedectvá, propagačné tvrdenia, pokyny na likvidáciu, dávkovanie, bezpečnostné varovania, úplné výživové údaje ani nesúvisiace špecifikácie do bloku zloženia. Tieto fakty môžu byť umiestnené v blízkosti vo vlastných riadených prvkoch. Nikdy neodvodzujte „bez obsahu“, hypoalergénne, vegánske, recyklovateľné, prírodné, organické, netoxické ani environmentálne vhodnejšie len zo zoznamu zložiek. Nikdy nepoužívajte fotografiu balenia ako jediné vyhlásenie, pretože jej text môže byť nečitateľný, neaktuálny, špecifický pre daný trh a nedostupný pre asistenčné technológie.

Typy príspevkov, ktoré ho používajú

Pole postTypes v frontmatter je implementačným zdrojom pre túto maticu.

Kontrolný zoznam QA

• Blok identifikuje presný produkt, SKU alebo formuláciu, trh a fyzický rozsah, ktorý opisuje.
• Vyhlásenie pochádza zo schváleného zdroja a jeho ID zdroja, revízia a dátum kontroly sú zachované.
• Každý názov zložky zodpovedá schválenému bežnému, technickému, štandardizovanému alebo regulovanému názvu.
• Zoradené vyhlásenia zachovávajú poradie zdroja; žiadny renderer neabecedne zoraďuje, nespája ani nepreskupuje riadky.
• Každá číselná hodnota má jednotku a viditeľný základ a rozsahy alebo hranice si zachovávajú svoje operátory.
• Percentá sa sčítavajú len v rámci platného zdieľaného rozsahu; vylúčené vrstvy, povrchové úpravy a komponenty sú identifikované.
• Chýbajúce, nulové, neuplatniteľné a neuvedené sú reprezentované ako odlišné stavy.
• Zložené zložky alebo vrstvené materiály používajú explicitné vnorené skupiny namiesto nejednoznačnej interpunkcie.
• Požadované zvýraznenie alergénov, účinných zložiek alebo regulácie zostáva k dispozícii v texte a pre asistenčné technológie.
• Viditeľný blok, produktový feed, zdroj balenia, výstup schémy a výber variantu si navzájom neodporujú.
• Žiadny riadok zloženia neobsahuje cenu, dostupnosť, promoakciu, svedectvo, nepodložený prínos ani odvodené environmentálne alebo bezpečnostné tvrdenia.
• Úplné vyhlásenie funguje bez obrázkov, hoveru, farby, JavaScriptu alebo rozšíreného desktopového rozloženia.
• Zmeny formulácie, dodávateľa, komponentu, balenia, jurisdikcie alebo revízie spúšťajú opätovnú validáciu.
• Tri syntaxové príklady zachovávajú rovnaký subjekt, rozsah, základ, riadky, zdroj a revíziu.

FAQ

Je blok zloženia to isté ako tabuľka špecifikácií?

Nie. Blok zloženia identifikuje, z čoho sa produkt skladá, a pokiaľ je to relevantné, aj množstvo alebo podiel každej zložky. Tabuľka špecifikácií opisuje merateľné charakteristiky, ako sú rozmery, kapacita, napätie alebo kompatibilita. Obe štruktúry udržiavajte oddelené, aj keď sa nachádzajú blízko seba.

Musí každá zložka obsahovať percento?

Nie. Percento uveďte vtedy, keď ho vyžaduje platný predpis, schválený zdroj alebo rozhodnutie kupujúceho. Nikdy neodvodzujte percento z poradia v zozname. Zachovajte schválené poradie zložiek a presné množstvo uveďte len vtedy, keď zdroj poskytuje platný základ a jednotku.

Môže marketing prepisovať regulované názvy zložiek alebo materiálov?

Nie. Zobrazované názvy možno doplniť vysvetlením v bežnom jazyku, ak to politika umožňuje, ale požadovaný právny alebo štandardizovaný názov musí zostať nedotknutý. Marketingový text nemôže nahradiť, skracovať, preskupiť ani zjemniť regulované vyhlásenie.

Generuje blok zloženia automaticky značkovanie schémy?

Nie. Niektoré polia je možné mapovať na hodnoty Product.material alebo additionalProperty, ale neexistuje univerzálny objekt Schema.org pre zloženie pre každú triedu produktov. Vytvárajte len podporované vlastnosti, ktoré presne opisujú viditeľný produkt, a nikdy nepoužívajte štruktúrované dáta ako náhradu za vyhlásenie na stránke.

Ako by sa malo líšiť zloženie medzi variantmi produktu alebo trhmi?

Priraďte blok ku konkrétnemu SKU a trhu. Ak zmena farby, veľkosti, príchute, receptúry, dodávateľa alebo destinácie mení vyhlásenie, zobrazte zodpovedajúci schválený záznam a identifikujte jeho rozsah. Nekombinujte viacero variantov do jedného zoznamu, pokiaľ nie sú všetky zložky a množstvá skutočne identické.