Autore:
    Creazione:2026-06-12Ultimo aggiornamento:2026-06-26

    Dizionari dinamici

    Intlayer supporta due meccanismi per esprimere contenuti che vanno oltre un singolo dizionario statico per chiave. Ciascuno è dichiarato tramite un campo di metadati di primo livello nel file di contenuto; non è necessaria alcuna funzione wrapper.

    Funzionalità Campo di metadati Selettore in useIntlayer
    Collezioni item: N { item: N }
    Varianti variant: "name" o variant: { … } { variant: "name" } o { variant: { … } }

    Entrambi si combinano con l'argomento locale e supportano il caricamento selettivo / differito tramite importMode.

    Quando usare cosa

    • Collezioni — elenco ordinato di elementi gestiti in file separati (voci di FAQ, articoli di blog, prodotti).
    • Varianti — alternative di contenuto con nome o strutturate:
      • una variante stringa per test A/B, banner stagionali o feature flag;
      • una variante oggetto per record di CMS, contenuti specifici per utente o qualsiasi contenuto indirizzato da un insieme di campi (i precedenti «record dinamici»).
    Le versioni precedenti esponevano un campo meta separato per i contenuti indicizzati per record. È stato unito in variant: passa un oggetto a variant invece di usare meta.

    Disambiguazione del selettore

    Una chiave può dichiarare entrambe le dimensioni contemporaneamente (ad es. una collezione i cui elementi hanno ciascuno una variante). Vengono risolte nell'ordine:

    plaintext
    variant → item

    Quindi { variant: "promo" } su una chiave variante × item restituisce tutti gli elementi promo come array, e aggiungere { item: 2 } lo restringe a una singola voce.

    Recupero funzione
    Collezioni