Blok składu: składniki, materiały i elementy składowe

Blok składu to strukturalna deklaracja z czego składa się produkt. Łączy w sobie nazwy składników, rodzaje materiałów, ilości komponentów, procenty, funkcje i wymagane kwalifikatory, aby kupujący nie musiał odtwarzać składu produktu ze zdjęć opakowań czy tekstów marketingowych.

Element oddziela produkt i zakres od każdego składnika i wartości. „65% poliestru z recyklingu” ma sens tylko wtedy, gdy czytelnik wie, czy opisuje tkaninę wierzchnią, podszewkę, wypełnienie, całą odzież czy opakowanie.

Dlaczego ten element jest ważny

Skład wpływa na decyzje, na które slogany produktowe nie potrafią odpowiedzieć. Kupujący może unikać alergenu, porównywać zawartość wełny, sprawdzać powłokę, wybierać nadające się do recyklingu opakowanie z jednego materiału lub potwierdzać stężenie aktywnego składnika. Może decydować, czy produkt jest bezpieczny, odpowiedni, łatwy w utrzymaniu, zgodny z polityką lub wart swojej ceny.

Struktura obniża koszt tej decyzji. Stwierdzenie „Wykonane z bawełny, poliestru z recyklingu i ochronnej powłoki” pozostawia czytelnikom odkrycie, do której części produktu należy każdy materiał i czy lista jest kompletna. Oznaczone wiersze sprawiają, że nazwy, wartości i braki są łatwe do przejrzenia.

Wyszukiwarki, systemy porównawcze, agenci zakupowi, narzędzia dostępności i kanały produktowe również muszą zachować relację między składnikiem, ilością, jednostką, częścią produktu i wariantem. Przecinki nie są w stanie wiarygodnie pokazać, czy „bawełna 35%, podszewka poliestrowa, powlekany poliuretanem” oznacza trzy procenty, dwa materiały i wykończenie, czy niekompletny tekst.

Regulowane deklaracje sprawiają, że niejednoznaczność jest poważniejszym problemem. Kontrolowane klasy produktów mogą mieć specyficzne dla rynku wymagania dotyczące nazewnictwa, kolejności, wyróżnienia, ilości i języka. Ponieważ obowiązki różnią się w zależności od produktu i jurysdykcji, zachowaj zatwierdzoną deklarację, rynek, rewizję i źródło; nigdy nie polegaj na tym, że autor lub system renderujący wywnioskuje zgodność. Struktura nie czyni treści zgodną, ale sprawia, że wymagane pola są testowalne.

Kiedy go używać

Używaj bloku składu za każdym razem, gdy tożsamość lub ilość składnika wpływa na wybór, bezpieczne użytkowanie, zgodność, porównanie, pielęgnację, recykling lub zaopatrzenie. Zastosowania obejmują:

• deklaracje składników żywności i napojów, z oddzielnie regulowanym wyróżnieniem alergenów, jeśli wymagane;
• nazwy składników kosmetycznych w zatwierdzonej kolejności i nomenklaturze;
• skład włókien tekstylnych podzielony na tkaninę wierzchnią, podszewkę, wypełnienie, wykończenie lub inną odpowiednią część;
• materiały meblowe i budowlane rozdzielone według warstwy strukturalnej lub komponentu;
• mieszanki chemiczne i składniki aktywne ze stężeniami i zadeklarowaną podstawą;
• suplementy lub produkty formulowane, których tożsamość i ilość składników muszą pozostać odrębne;
• skład opakowania wykorzystywany do utylizacji, recyklingu lub deklaracji środowiskowych;
• zespoły techniczne, gdzie „skład” oznacza ograniczony wykaz materiałów składowych, a nie pełny katalog części.

Używaj jednego bloku dla jednego zatwierdzonego zakresu. Materac może mieć nazwane grupy: pokrycie, warstwę komfortową i rdzeń; różne smaki wymagają oddzielnych rekordów. Każdy wiersz musi być prawdziwy dla produktu, wariantu, rynku i rewizji wymienionych na górze.

Bliskie przypadki wymagają innych struktur. Wymiary, napięcie, kompatybilność i wydajność to specyfikacje. Wartość odżywcza opisuje składniki odżywcze i porcję, niekoniecznie składniki. Instrukcje pielęgnacji opisują zachowanie po zakupie. Oddzielne oświadczenia dotyczące alergenów wymagają własnego zatwierdzonego traktowania. „Przyjazny planecie” nie jest ani składnikiem, ani dowodem. Wykaz materiałów produkcyjnych może być zbyt szczegółowy lub poufny dla klientów.

Zasady pisania elementów mają pierwszeństwo: wybierz typowany element zgodnie z przeznaczeniem fragmentu. Jeśli zadaniem bloku jest określenie, z czego składa się dany obiekt, użyj składu, nawet jeśli ogólna tabela, akordeon lub akapit mógłby imitować jego wygląd.

Gdzie go umieścić

Umieść główny blok po tożsamości produktu i informacjach zakupowych, ale przed oświadczeniami, instrukcjami lub wskazówkami zależnymi od składu. Zwykle poprzedza on pielęgnację, bezpieczeństwo, zrównoważony rozwój i szczegółowe specyfikacje. Wymogi regulacyjne dotyczące umiejscowienia mają pierwszeństwo przed preferencjami redakcyjnymi.

Zwarte podsumowanie w strefie zakupowej musi zawierać kluczowe dla decyzji fakty oraz udostępniać pełną deklarację bez zmiany kontekstu. Zachowaj pełną treść w źródle strony i dostępną bez JavaScriptu.

Umieść blok obok jego etykiety zakresu. Może znajdować się obok obrazu lub tabeli specyfikacji z wyraźnymi nagłówkami. Nie może znajdować się obok oświadczenia innego wariantu, niekwalifikowanej odznaki ekologicznej ani sprzecznego przekazu marketingowego. Nigdy nie wstawiaj rekomendacji, oferty, cross-sellu ani CTA między nagłówek deklaracji a wiersze.

W przypadku pakietów wieloczęściowych, zestawów i produktów konfigurowalnych, umieść każdy niezależnie formułowany przedmiot w oznakowanej podgrupie. Nigdy nie uśredniaj składu w obrębie zestawu. Na urządzeniach mobilnych zachowaj kolejność: podmiot i zakres, podstawa, składniki, kwalifikatory, źródło lub rewizja. Kolumny wizualne mogą się zwijać, ale relacje nie mogą.

Anatomia

1. Tytuł: określa deklarację wprost, np. „Składniki”, „Skład materiałowy” lub „Składniki aktywne”.
2. Tożsamość podmiotu: wiąże treść z dokładnym produktem, SKU, wariantem, formulacją lub komponentem.
3. Zakres: określa rynek, część produktu, stan przygotowania, element opakowania lub inną granicę określającą, co opisują wiersze.
4. Podstawa deklaracji: wyjaśnia, co oznaczają ilości, np. procent wagowo włókien, miligramy na tabletkę lub gramy na 100 gramów w sprzedaży.
5. Nazwa składnika: zachowuje zatwierdzoną nazwę zwyczajową, techniczną, znormalizowaną lub regulowaną.
6. Ilość: podaje liczbę, zakres, próg lub celowo nieobecny stan bez domysłów.
7. Jednostka lub proporcja: pozostaje przywiązana do swojej ilości i używa jednej zdefiniowanej konwencji w obrębie grupy.
8. Rola lub kwalifikator: identyfikuje funkcje, składniki wtórne, powłoki, nośniki, substancje pomocnicze lub wyłączenia tylko wtedy, gdy są zatwierdzone i istotne.
9. Wymagane wyróżnienie: uwidacznia alergen, składnik aktywny lub wymagane sformułowanie poprzez tekst i znaczniki semantyczne, nie tylko kolor.
10. Pochodzenie: rejestruje zatwierdzone źródło, rynek, rewizję i datę przeglądu użyte do wyrenderowania deklaracji.

Przykłady projektowe

Każdy wariant projektowy wykorzystuje te same bazowe rekordy składników. Wariant zmienia etykiety i grupowanie, ponieważ klasa produktu zadaje inne pytanie; nigdy nie zamienia zweryfikowanej deklaracji w dowolny tekst promocyjny.

Uporządkowane składniki. Używaj, gdy kolejność ma znaczenie lub jest regulowana. Zachowaj kolejność źródła, interpunkcję, składniki zagnieżdżone i wymagane wyróżnienie. Nie alfabetyzuj dla estetyki wizualnej ani nie łącz dwóch zatwierdzonych nazw w przyjaźniejszą etykietę.

Procenty materiałów według komponentu. Używaj w przypadku tekstyliów, mebli, opakowań lub towarów warstwowych. Grupuj według części fizycznej, określ, do czego sumują się procenty w obrębie grupy i odróżnij obróbkę powierzchniową od bazowego włókna lub materiału.

Składniki aktywne i stężenia. Używaj, gdy substancja aktywna lub funkcjonalny składnik musi być określony ilościowo. Zachowaj razem ilość, jednostkę, podstawę i stan produktu. Ostrzeżenia dotyczące bezpieczeństwa i instrukcje pozostają oddzielnymi regulowanymi elementami, nawet jeśli pochodzą z tego samego źródła.

Warstwowa kompozycja techniczna. Używaj w przypadku zespołów takich jak podłogi, izolacje, filtry lub materace. Przedstaw hierarchię fizyczną wprost. Grubość może pojawić się jako kwalifikator składnika, ale niezwiązane specyfikacje wydajności należą do własnej tabeli.

Zwarte porównanie. Używaj tylko wtedy, gdy dwa lub więcej produktów ma rzeczywiście porównywalne kategorie składników. Pokaż „Nie zadeklarowano” lub „Nie dotyczy” zamiast pustej komórki. Zachowaj pełny autorytatywny blok w każdym rekordzie produktu; porównanie jest widokiem pochodnym, a nie nowym źródłem.

Parametry

„Źródło” określa, skąd system renderujący pobiera każde pole. Zatwierdzony rekord produktu lub regulacji pozostaje autorytatywny; treść może dodać kontrolowany kontekst wyjaśniający, ale nie może nadpisywać faktów związanych ze źródłem.

Dozwolone wartości item.flag są kontrolowane przez implementację, na przykład allergen, active, restricted lub regulated-name. Flaga uruchamia zatwierdzoną prezentację i walidację; autorzy nie mogą używać dowolnych flag do tworzenia ostrzeżeń lub odznak marketingowych.

Składnia i przykłady kodu

Wszystkie trzy formy kodują ten sam rekord tkaniny wierzchniej kurtki. Przenośna dyrektywa jest kanoniczną reprezentacją autorską; przed opublikowaniem projekt musi zaimplementować i przetestować adaptery Hugo i WordPress.

Przenośna dyrektywa 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.
:::

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

Każdy parametr Hugo jest nazwany. Przykład nie miesza parametrów pozycyjnych i nazwanych.

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]

Natywny blok WordPress powinien przechowywać składniki jako powtarzalne typowane rekordy, a nie jako jedno pole tekstu sformatowanego. Zablokuj nazwy i wartości powiązane ze źródłem, gdy pochodzą z systemu zarządzania informacją o produkcie, jednocześnie umożliwiając autoryzowanemu recenzentowi zatwierdzenie prezentacji specyficznej dla rynku.

Dobre i złe przykłady

Dobry

Skład materiałowy — kurtka robocza Harbor HJ-204, tkanina wierzchnia: 65% poliester z recyklingu; 35% bawełna organiczna. Procenty są wagowo włókien tkaniny wierzchniej. Powłoka poliuretanowa jest wyłączona z procentowego udziału włókien. Podszewka: 100% poliester. Zatwierdzone źródło HJ-204-US, rewizja 6.

Działa to, ponieważ określa dokładny produkt i części, podaje podstawę dla każdej grupy procentowej, odróżnia powłokę od włókien oraz ujawnia zatwierdzoną rewizję. Wartości sumują się w obrębie swojego zadeklarowanego zakresu, zamiast udawać, że opisują całą kurtkę.

Zły

Premium eko-mieszanka: Głównie naturalna bawełna z włóknami z recyklingu o wysokiej wydajności i przyjazną dla planety ochronną powłoką.

To nie działa, ponieważ „głównie” nie jest ilością, „mieszanka” ukrywa relacje między materiałami, a „powłoka” nie ma tożsamości chemicznej ani składnikowej. Pomija zakres tkanina wierzchnia kontra podszewka, zawiera niepoparte roszczenie środowiskowe i nie podaje źródła ani rewizji. Kupujący nie może tego porównać, a maszyna nie może wyodrębnić uzasadnionych składników.

Znaczniki schematu i dostępność

Nie istnieje uniwersalny schemat składu obejmujący wszystkie regulowane klasy produktów. Dla rzeczywistego Product, prosty materiał może być mapowany na Schema.org material. Nazwane fakty można czasami mapować przez additionalProperty i PropertyValue, zachowując razem name, value oraz unitText lub unitCode. Stabilne identyfikatory muszą wiązać je z widocznym wariantem.

Nie wymuszaj deklaracji w niepowiązanych właściwościach. Recipe.recipeIngredient opisuje przepis, a nie etykietę produktu pakowanego. Nigdy nie emituj procentu z kolejności na liście ani nie zamieniaj wnioskowania o środowisku lub alergenie w fakt. Generuj kanały branżowe z zatwierdzonego rekordu, a nie z wyrenderowanego HTML-a.

Dane strukturalne uzupełniają, ale nigdy nie zastępują widocznej deklaracji. Maszyny nie mogą otrzymywać bogatszej ani inaczej zakresowej wersji. Jeśli schemat nie może wyrazić podstawy lub kwalifikatora, pomiń właściwość i zachowaj widoczny fakt.

Używaj prawdziwego nagłówka i jednego kontenera semantycznego na deklarację. Uporządkowane składniki używają list; rekordy nazwa-wartość używają list opisowych lub tabel z nagłówkami. Zagnieżdżone związki wymagają zagnieżdżonej struktury list. Kolejność odczytu przez czytnik ekranu musi odpowiadać zatwierdzonej kolejności.

Nigdy nie polegaj wyłącznie na pogrubieniu, wielkich literach, kolorze, ikonach czy podpowiedziach w przypadku alergenów lub statusu regulowanego. Dołącz wymagany tekst w dostępnej treści. Rozwijane elementy wymagają przycisku, dokładnego stanu, obsługi klawiatury i awaryjnego rozwiązania renderowanego po stronie serwera. Widoczne i dostępne jednostki muszą być zgodne.

Zasady pisania

Blok zachowuje dokładną prawdę o produkcie, więc zwięzłość nie może usprawiedliwiać pomijania zakresu, podstawy, kwalifikatorów ani wymaganych nazw. Stosuj te zasady po potwierdzeniu źródła i polityki rynkowej:

• Nazwij blok w jednym do pięciu słów. Preferuj słownictwo, którego oczekują kupujący i regulatorzy: „Składniki”, „Skład materiałowy” lub „Składniki aktywne”.
• Uwzględnij od jednego do 100 wierszy. Powyżej tego użyj kontrolowanego grupowania lub zatwierdzonego dokumentu; nigdy nie obcinaj po cichu.
• Tam, gdzie to możliwe, utrzymuj nazwy do 120 znaków, ale zachowaj dłuższe regulowane nazwy w nienaruszonym stanie.
• Zachowaj wymaganą kolejność. W przeciwnym razie utrzymuj zatwierdzoną sekwencję rekordu produktu we wszystkich kanałach.
• Dołącz ilości do jednostek i podstawy. Nigdy nie wymuszaj nieporównywalnych warstw w fałszywej sumie 100%.
• Używaj cyfr dla ilości i kontrolowanych symboli jednostek. Dostosuj prezentację dziesiętną i jednostkową bez zmiany przechowywanej wartości.
• Rozróżnij „Nie zadeklarowano”, „Nie dotyczy”, „Ilość nie podana” i zero; puste pole jest niejednoznaczne.
• Ogranicz notatki do 40 słów po danej grupie. Wyjaśniają one zakres, ale nie mogą nadpisywać wierszy.
• Używaj rzeczowego, neutralnego języka. Trzymaj wyjaśnienia oddzielnie od nazw prawnych lub znormalizowanych.
• Sprawdź dokładną klasę produktu, rynek, język, wariant i rewizję. Ponownie zatwierdź każdą istotną zmianę.

Nigdy nie umieszczaj ceny, stanu magazynowego, dostawy, rekomendacji, roszczeń promocyjnych, instrukcji utylizacji, dawkowania, ostrzeżeń bezpieczeństwa, pełnych informacji o wartości odżywczej ani niepowiązanych specyfikacji wewnątrz bloku składu. Te fakty mogą znajdować się w pobliżu we własnych regulowanych elementach. Nigdy nie wnioskuj o „wolny od”, hipoalergiczności, wegańskości, możliwości recyklingu, naturalności, organiczności, nietoksyczności lub preferencyjności środowiskowej wyłącznie z listy składników. Nigdy nie używaj zdjęcia opakowania jako jedynej deklaracji, ponieważ jego tekst może być nieczytelny, nieaktualny, specyficzny dla rynku i niedostępny dla technologii wspomagających.

Typy postów, które go używają

Pole postTypes w metadanych jest źródłem implementacji dla tej macierzy.

Lista kontrolna QA

• Blok identyfikuje dokładny produkt, SKU lub formulację, rynek i zakres fizyczny, który opisuje.
• Deklaracja pochodzi z zatwierdzonego źródła, a jej ID źródła, rewizja i data przeglądu są zachowane.
• Każda nazwa składnika odpowiada zatwierdzonej nazwie zwyczajowej, technicznej, znormalizowanej lub regulowanej.
• Uporządkowane deklaracje zachowują kolejność źródła; żaden system renderujący nie alfabetyzuje, nie łączy ani nie zmienia kolejności wierszy.
• Każda wartość liczbowa ma jednostkę i widoczną podstawę, a zakresy lub progi zachowują swoje operatory.
• Procenty sumują się tylko w ramach prawidłowego wspólnego zakresu; wyłączone warstwy, powłoki i komponenty są zidentyfikowane.
• Brakujące, zerowe, nie dotyczy i niezadeklarowane są reprezentowane jako odrębne stany.
• Złożone składniki lub materiały warstwowe używają jawnych grup zagnieżdżonych, a nie niejednoznacznej interpunkcji.
• Wymagane wyróżnienie alergenu, składnika aktywnego lub regulacji pozostaje dostępne w tekście i dla technologii wspomagających.
• Widoczny blok, kanał produktowy, źródło opakowania, wynik schematu i wybór wariantu nie są ze sobą sprzeczne.
• Żaden wiersz składu nie zawiera ceny, dostępności, promocji, rekomendacji, niepopartych korzyści ani wnioskowanych roszczeń środowiskowych lub bezpieczeństwa.
• Pełna deklaracja działa bez obrazów, najechania kursorem, koloru, JavaScriptu ani rozszerzonego widoku na desktopie.
• Zmiany formulacji, dostawcy, komponentu, opakowania, jurysdykcji lub rewizji uruchamiają ponowną walidację.
• Trzy przykłady składni zachowują ten sam podmiot, zakres, podstawę, wiersze, źródło i rewizję.

FAQ

Czy blok składu to to samo co tabela specyfikacji?

Nie. Blok składu określa, z czego składa się produkt i, jeśli ma to znaczenie, ilość lub proporcję każdego składnika. Tabela specyfikacji opisuje mierzalne cechy, takie jak wymiary, pojemność, napięcie czy kompatybilność. Te dwie struktury należy trzymać osobno, nawet jeśli występują obok siebie.

Czy każdy składnik musi zawierać procent?

Nie. Podaj procent, gdy wymagają tego przepisy, zatwierdzone źródło lub decyzja kupującego. Nigdy nie wnioskuj o procent na podstawie kolejności na liście. Zachowaj zatwierdzoną kolejność składników i podaj dokładną ilość tylko wtedy, gdy źródło podaje ważną podstawę i jednostkę.

Czy dział marketingu może zmieniać nazwy regulowanych składników lub materiałów?

Nie. Wyświetlane nazwy mogą być uzupełnione o wyjaśnienie w prostym języku, jeśli polityka na to pozwala, ale wymagana prawnie lub znormalizowana nazwa musi pozostać nienaruszona. Treści marketingowe nie mogą zastępować, skracać, zmieniać kolejności ani łagodzić regulowanego oświadczenia.

Czy blok składu automatycznie generuje znaczniki schematu?

Nie. Niektóre pola można mapować na wartości Product.material lub additionalProperty, ale nie istnieje uniwersalny obiekt składu Schema.org dla każdej klasy produktów. Emituj tylko obsługiwane właściwości, które dokładnie opisują widoczny produkt i nigdy nie używaj danych strukturalnych jako substytutu deklaracji na stronie.

Jak skład powinien różnić się między wariantami produktu lub rynkami?

Powiąż blok z dokładnym SKU i rynkiem. Jeśli kolor, rozmiar, smak, formuła, dostawca lub miejsce przeznaczenia zmienia deklarację, wyrenderuj pasujący zatwierdzony rekord i określ jego zakres. Nie łącz kilku wariantów w jedną listę, chyba że każdy składnik i ilość są rzeczywiście identyczne.