Blocos de Composição: Ingredientes, Materiais e Constituintes

Um bloco de composição é uma declaração estruturada de em que consiste um produto. Ele mantém nomes de ingredientes, tipos de materiais, quantidades de componentes, percentuais, funções e qualificadores exigidos juntos, para que o comprador não precise reconstruir o produto a partir de fotografias da embalagem ou textos de marketing.

O elemento separa o produto e o escopo de cada constituinte e valor. “65% poliéster reciclado” só tem significado quando o leitor sabe se descreve o tecido externo, o forro, o enchimento, a peça inteira ou a embalagem.

Por que este elemento é importante

A composição afeta decisões que slogans de produto não conseguem responder. Um comprador pode evitar um alérgeno, comparar o teor de lã, verificar um revestimento, escolher uma embalagem monomaterial reciclável ou confirmar a concentração de um componente ativo. Ele pode estar decidindo se o produto é seguro, adequado, manutenível, compatível com políticas ou vale seu preço.

A estrutura reduz esse custo de decisão. “Feito com algodão, poliéster reciclado e um revestimento protetor” deixa os leitores tendo que descobrir a que parte cada material pertence e se a lista está completa. Linhas rotuladas tornam nomes, valores e omissões fáceis de escanear.

Mecanismos de busca, sistemas de comparação, agentes de compras, ferramentas de acessibilidade e feeds de produto também precisam reter a relação entre um constituinte, quantidade, unidade, parte do produto e variante. Vírgulas não conseguem mostrar confiavelmente se “algodão 35%, forro de poliéster, revestido com poliuretano” significa três percentuais, dois tecidos e um acabamento, ou texto incompleto.

Declarações regulamentadas tornam a ambiguidade mais grave. Classes de produto controladas podem ter requisitos específicos de nomenclatura, ordenação, ênfase, quantidade e idioma por mercado. Como as obrigações diferem por produto e jurisdição, preserve a declaração aprovada, o mercado, a revisão e a fonte; nunca peça a um redator ou renderizador que infira conformidade. A estrutura não torna o conteúdo conforme, mas torna os campos obrigatórios testáveis.

Quando usar

Use um bloco de composição sempre que a identidade ou quantidade de um constituinte influenciar a seleção, o uso seguro, a conformidade, a comparação, o cuidado, a reciclagem ou a aquisição. As aplicações incluem:

• declarações de ingredientes de alimentos e bebidas, com ênfase em alérgenos regulamentada separadamente, quando exigido;
• nomes de ingredientes cosméticos na ordem e nomenclatura aprovadas;
• composição de fibras têxteis dividida por tecido externo, forro, enchimento, guarnição ou outra parte relevante;
• materiais de mobiliário e construção separados por camada estrutural ou componente;
• misturas químicas e componentes ativos com concentrações e uma base declarada;
• suplementos ou produtos formulados cuja identidade e quantidade do ingrediente devem permanecer distintas;
• composição de embalagens usada para descarte, reciclagem ou alegações ambientais;
• conjuntos técnicos onde “composição” significa uma lista delimitada de materiais constituintes, em vez de um catálogo completo de peças.

Use um bloco por escopo aprovado. Um colchão pode ter grupos nomeados de capa, camada de conforto e núcleo; sabores diferentes precisam de registros separados. Cada linha deve permanecer verdadeira para o produto, variante, mercado e revisão nomeados no topo.

Casos próximos precisam de estruturas diferentes. Dimensões, voltagem, compatibilidade e desempenho são especificações. Nutrição descreve nutrientes e uma base de porção, não necessariamente ingredientes. Instruções de cuidado descrevem comportamento após a compra. Declarações separadas de alérgenos precisam de seu próprio tratamento aprovado. “Amigo do planeta” não é um constituinte nem uma evidência. Uma lista de materiais de fabricação pode ser detalhada ou confidencial demais para clientes.

As regras de escrita de elementos têm precedência: selecione o elemento tipado pelo propósito da passagem. Se a função do bloco é identificar em que consiste o assunto, use composição mesmo que uma tabela genérica, acordeão ou parágrafo possa imitar sua aparência.

Onde posicionar

Posicione o bloco principal após a identidade do produto e os fatos de compra, mas antes de alegações, instruções ou orientações que dependam da composição. Ele normalmente precede cuidados, segurança, sustentabilidade e especificações detalhadas. Requisitos regulatórios de posicionamento substituem a preferência editorial.

Um resumo compacto na região de compra deve incluir fatos críticos para a decisão e expor a declaração completa sem mudar de contexto. Mantenha o conteúdo completo na fonte da página e acessível sem JavaScript.

Mantenha o bloco junto ao seu rótulo de escopo. Ele pode ficar ao lado de uma imagem ou tabela de especificações com cabeçalhos claros. Não pode ficar ao lado da alegação de outra variante, de um selo ambiental não qualificado ou de marketing contraditório. Nunca insira um depoimento, oferta, venda cruzada ou CTA entre o cabeçalho da declaração e as linhas.

Para multipacks, kits e produtos configuráveis, coloque cada item formulado independentemente em um subgrupo rotulado. Nunca calcule médias de composição em todo o kit. No mobile, preserve a ordem: assunto e escopo, base, constituintes, qualificadores, fonte ou revisão. Colunas visuais podem colapsar, mas relacionamentos não podem.

Anatomia

1. Título: nomeia a declaração de forma clara, como “Ingredientes”, “Composição do material” ou “Componentes ativos”.
2. Identidade do assunto: vincula o conteúdo a um produto, SKU, variante, formulação ou componente exato.
3. Escopo: indica o mercado, parte do produto, estado de preparação, componente da embalagem ou outro limite que determina o que as linhas descrevem.
4. Base da declaração: explica o que as quantidades significam, como percentual do peso da fibra, miligramas por comprimido ou gramas por 100 gramas conforme vendido.
5. Nome do constituinte: preserva o nome comum, técnico, padronizado ou regulamentado aprovado.
6. Quantidade: fornece um número, faixa, limite ou estado intencionalmente ausente sem adivinhação.
7. Unidade ou proporção: permanece vinculada à sua quantidade e usa uma convenção definida dentro de um grupo.
8. Função ou qualificador: identifica funções, subingredientes, revestimentos, carreadores, auxiliares de processamento ou exclusões apenas quando aprovado e relevante.
9. Ênfase exigida: expõe um alérgeno, componente ativo ou frase obrigatória por meio de texto e marcação semântica, não apenas por cor.
10. Proveniência: registra a fonte aprovada, mercado, revisão e data de revisão usados para renderizar a declaração.

Exemplos de design

Cada variante de design usa os mesmos registros de constituintes subjacentes. A variante altera rótulos e agrupamentos porque a classe do produto faz uma pergunta diferente; nunca transforma uma declaração verificada em texto promocional de forma livre.

Ingredientes ordenados. Use quando a sequência é significativa ou regulamentada. Preserve a ordem da fonte, pontuação, ingredientes aninhados e ênfase exigida. Não alfabetize por organização visual nem mescle dois nomes aprovados em um rótulo mais amigável.

Percentuais de material por componente. Use para têxteis, móveis, embalagens ou produtos em camadas. Agrupe por parte física, indique em que os percentuais totalizam e distinga um tratamento de superfície da fibra ou material subjacente.

Componentes ativos e concentrações. Use quando uma substância ativa ou constituinte funcional deve ser quantificado. Mantenha quantidade, unidade, base e estado do produto juntos. Avisos de segurança e instruções permanecem como elementos regidos separadamente, mesmo quando derivam da mesma fonte.

Composição técnica em camadas. Use para conjuntos como pisos, isolamentos, filtros ou colchões. Represente a hierarquia física explicitamente. A espessura pode aparecer como um qualificador do constituinte, mas especificações de desempenho não relacionadas pertencem à sua própria tabela.

Comparação compacta. Use apenas quando dois ou mais produtos tiverem categorias de constituintes genuinamente comparáveis. Mostre “Não declarado” ou “Não aplicável” em vez de uma célula vazia. Mantenha o bloco autoritativo completo em cada registro do produto; a comparação é uma visualização derivada, não uma nova fonte.

Parâmetros

“Fonte” identifica onde o renderizador obtém cada campo. O registro de produto ou regulatório aprovado permanece autoritativo; o corpo pode adicionar contexto explicativo controlado, mas não pode substituir fatos vinculados à fonte.

Os valores permitidos de item.flag são controlados pela implementação, por exemplo allergen, active, restricted ou regulated-name. Uma flag aciona apresentação e validação aprovadas; autores não podem usar flags arbitrárias para criar avisos ou selos de marketing.

Sintaxe e exemplos de código

As três formas codificam o mesmo registro do tecido externo da jaqueta. A diretiva portátil é a representação canônica de autoria; um projeto deve implementar e testar os adaptadores Hugo e WordPress antes de publicá-lo.

Diretiva Markdown portátil

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

Todo parâmetro Hugo é nomeado. O exemplo não mistura parâmetros posicionais e nomeados.

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]

Um bloco nativo do WordPress deve armazenar constituintes como registros tipados repetíveis, não como um único campo de rich text. Bloqueie nomes e valores vinculados à fonte quando vierem de um sistema de gerenciamento de informações do produto, permitindo que um revisor autorizado aprove a apresentação específica do mercado.

Exemplos bons e ruins

Bom

Composição do material — Jaqueta de trabalho Harbor HJ-204, tecido externo: 65% poliéster reciclado; 35% algodão orgânico. Percentuais são por peso de fibra do tecido externo. Revestimento de poliuretano é excluído dos percentuais de fibra. Forro: 100% poliéster. Fonte aprovada HJ-204-US, revisão 6.

Funciona porque nomeia o produto e as partes exatas, fornece uma base para cada grupo percentual, distingue o revestimento das fibras e expõe a revisão aprovada. Os valores totalizam dentro de seu escopo declarado, em vez de fingir descrever a jaqueta inteira.

Ruim

Mistura ecológica premium: Principalmente algodão natural com fibras recicladas de desempenho e um acabamento protetor amigo do planeta.

Falha porque “principalmente” não é uma quantidade, “mistura” esconde a relação entre os materiais e “acabamento” não tem identidade química ou de componente. Omite o escopo tecido externo versus forro, faz uma alegação ambiental sem suporte e não fornece fonte ou revisão. Um comprador não pode compará-lo, e uma máquina não pode extrair constituintes defensáveis.

Marcação Schema e acessibilidade

Nenhum schema de composição universal cobre toda classe de produto regulamentada. Para um Product genuíno, um material simples pode ser mapeado para material do Schema.org. Fatos nomeados podem às vezes ser mapeados por meio de additionalProperty e PropertyValue, mantendo name, value e unitText ou unitCode juntos. Identificadores estáveis devem vinculá-los à variante visível.

Não force declarações em propriedades não relacionadas. Recipe.recipeIngredient descreve uma receita, não um rótulo de produto embalado. Nunca emita um percentual a partir da ordem da lista nem transforme uma inferência ambiental ou de alérgeno em fato. Gere feeds setoriais a partir do registro aprovado, não do HTML renderizado.

Dados estruturados complementam, nunca substituem, a declaração visível. Máquinas não devem receber uma versão mais rica ou de escopo diferente. Se o schema não puder expressar uma base ou qualificador, omita a propriedade e preserve o fato visível.

Use um cabeçalho real e um contêiner semântico por declaração. Ingredientes ordenados usam listas; registros nome-valor usam listas de descrição ou tabelas com cabeçalhos. Compostos aninhados precisam de estrutura de lista aninhada. A ordem do leitor de tela deve corresponder à ordem aprovada.

Nunca confie apenas em negrito, maiúsculas, cor, ícones ou dicas de ferramentas para alérgenos ou status regulamentado. Inclua o texto exigido no conteúdo acessível. Expansores precisam de um botão, estado preciso, operação por teclado e fallback renderizado no servidor. Unidades visíveis e acessíveis devem concordar.

Regras de escrita

O bloco preserva a verdade exata do produto, portanto a brevidade não pode justificar omitir escopo, base, qualificadores ou nomes exigidos. Aplique estas regras após confirmar a fonte e a política de mercado:

• Nomeie o bloco em uma a cinco palavras. Prefira o vocabulário que compradores e reguladores esperam: “Ingredientes”, “Composição do material” ou “Componentes ativos”.
• Inclua de uma a 100 linhas. Acima disso, use agrupamento regulado ou um documento aprovado; nunca trunque silenciosamente.
• Mantenha nomes em até 120 caracteres quando possível, mas preserve nomes regulamentados mais longos intactos.
• Preserve a ordem exigida. Caso contrário, retenha a sequência do registro de produto aprovado em todos os canais.
• Vincule quantidades a unidades e uma base. Nunca force camadas incomparáveis a um falso total de 100%.
• Use numerais para quantidades e símbolos de unidade controlados. Localize a apresentação de decimais e unidades sem alterar o valor armazenado.
• Distinga “Não declarado”, “Não aplicável”, “Quantidade não fornecida” e zero; um campo em branco é ambíguo.
• Mantenha notas em até 40 palavras após o grupo afetado. Elas esclarecem o escopo, mas não podem substituir linhas.
• Use linguagem factual e neutra. Mantenha explicações separadas dos nomes legais ou padronizados.
• Revise a classe exata do produto, mercado, idioma, variante e revisão. Revalide a cada alteração relevante.

Nunca coloque preço, estoque, entrega, depoimentos, alegações promocionais, instruções de descarte, orientações de dosagem, avisos de segurança, informações nutricionais completas ou especificações não relacionadas dentro do bloco de composição. Esses fatos podem ficar próximos em seus próprios elementos regidos. Nunca infira “livre de”, hipoalergênico, vegano, reciclável, natural, orgânico, não tóxico ou ambientalmente preferível apenas a partir de uma lista de constituintes. Nunca use uma fotografia da embalagem como única declaração, pois seu texto pode ser ilegível, desatualizado, específico do mercado e indisponível para tecnologias assistivas.

Tipos de post que o utilizam

O campo postTypes do frontmatter é a fonte de implementação para esta matriz.

Checklist de QA

• O bloco identifica o produto, SKU ou formulação, mercado e escopo físico exatos que descreve.
• A declaração vem de uma fonte aprovada, e seu ID de fonte, revisão e data de revisão são mantidos.
• Cada nome de constituinte corresponde ao nome comum, técnico, padronizado ou regulamentado aprovado.
• Declarações ordenadas preservam a ordem da fonte; nenhum renderizador alfabetiza, mescla ou reordena as linhas.
• Todo valor numérico tem uma unidade e uma base visível, e faixas ou limites retêm seus operadores.
• Percentuais totalizam apenas dentro de um escopo compartilhado válido; camadas, revestimentos e componentes excluídos são identificados.
• Ausente, zero, não aplicável e não declarado são representados como estados distintos.
• Ingredientes compostos ou materiais em camadas usam grupos aninhados explícitos em vez de pontuação ambígua.
• A ênfase exigida em alérgenos, componentes ativos ou regulamentações permanece disponível em texto e para tecnologia assistiva.
• O bloco visível, o feed do produto, a fonte da embalagem, a saída do schema e a seleção de variante não se contradizem.
• Nenhuma linha de composição contém preço, disponibilidade, promoção, depoimento, benefício sem suporte ou alegações ambientais ou de segurança inferidas.
• A declaração completa funciona sem imagens, hover, cor, JavaScript ou layout desktop expandido.
• Mudanças na formulação, fornecedor, componente, embalagem, jurisdição ou revisão acionam revalidação.
• Os três exemplos de sintaxe preservam o mesmo assunto, escopo, base, linhas, fonte e revisão.

FAQ

Um bloco de composição é o mesmo que uma tabela de especificações?

Não. Um bloco de composição identifica em que consiste um produto e, quando relevante, a quantidade ou proporção de cada constituinte. Uma tabela de especificações descreve características mensuráveis como dimensões, capacidade, voltagem ou compatibilidade. Mantenha as duas estruturas separadas, mesmo quando aparecerem próximas.

Todo ingrediente deve incluir um percentual?

Não. Inclua um percentual quando a regra vigente, a fonte aprovada ou a decisão do comprador o exigir. Nunca infira um percentual a partir da ordem da lista. Preserve a ordem de ingredientes aprovada e exiba um valor exato apenas quando a fonte fornecer uma base e unidade válidas.

O marketing pode renomear ingredientes ou materiais regulamentados?

Não. Nomes de exibição podem ser complementados com uma explicação em linguagem simples quando a política permitir, mas o nome legal ou padronizado exigido deve permanecer intacto. O texto de marketing não pode substituir, abreviar, reordenar ou suavizar uma declaração regulamentada.

Um bloco de composição gera automaticamente marcação schema?

Não. Alguns campos podem ser mapeados para valores de Product.material ou additionalProperty, mas não existe um objeto Schema.org de composição universal para toda classe de produto. Emita apenas propriedades suportadas que descrevam com precisão o produto visível e nunca use dados estruturados como substituto para a declaração na página.

Como a composição deve diferir entre variantes ou mercados do produto?

Vincule o bloco ao SKU e mercado exatos. Se cor, tamanho, sabor, fórmula, fornecedor ou destino alterar a declaração, renderize o registro aprovado correspondente e identifique seu escopo. Não combine várias variantes em uma única lista, a menos que todo constituinte e quantidade sejam genuinamente idênticos.