Autor:
    Criação:2026-06-12Última atualização:2026-06-26

    Dicionários dinâmicos

    O Intlayer suporta dois mecanismos para expressar conteúdo que vai além de um único dicionário estático por chave. Cada um é declarado por meio de um campo de metadados de nível superior no arquivo de conteúdo; nenhuma função de invólucro é necessária.

    Recurso Campo de metadados Seletor em useIntlayer
    Coleções item: N { item: N }
    Variantes variant: "name" ou variant: { … } { variant: "name" } ou { variant: { … } }

    Ambos se combinam com o argumento de locale e suportam carregamento seletivo / preguiçoso via importMode.

    Quando usar cada um

    • Coleções — lista ordenada de itens gerenciados em arquivos separados (entradas de FAQ, posts de blog, produtos).
    • Variantes — alternativas de conteúdo nomeadas ou estruturadas:
      • uma variante de string para testes A/B, banners sazonais ou feature flags;
      • uma variante de objeto para registros de CMS, conteúdo específico do usuário ou qualquer conteúdo endereçado por um conjunto de campos (os antigos «registros dinâmicos»).
    Versões anteriores expunham um campo meta separado para conteúdo indexado por registro. Ele foi fundido em variant: passe um objeto para variant em vez de usar meta.

    Desambiguação do seletor

    Uma chave pode declarar ambas as dimensões ao mesmo tempo (por exemplo, uma coleção cujos itens têm cada um uma variante). Elas são resolvidas na ordem:

    plaintext
    variant → item

    Assim, { variant: "promo" } em uma chave variante × item retorna todos os itens promo como um array, e adicionar { item: 2 } o restringe a uma única entrada.