Autor:
    Erstellung:2026-06-12Letzte Aktualisierung:2026-06-26

    Dynamische Wörterbücher

    Intlayer unterstützt zwei Mechanismen, um Inhalte auszudrücken, die über ein einzelnes statisches Wörterbuch pro Schlüssel hinausgehen. Jeder wird über ein Metadatenfeld auf oberster Ebene in der Inhaltsdatei deklariert; es ist keine Wrapper-Funktion nötig.

    Funktion Metadatenfeld Selektor in useIntlayer
    Sammlungen item: N { item: N }
    Varianten variant: "name" oder variant: { … } { variant: "name" } oder { variant: { … } }

    Beide lassen sich mit dem locale-Argument kombinieren und unterstützen selektives / verzögertes Laden über importMode.

    Wann was verwenden

    • Sammlungen — geordnete Liste von Elementen, die in separaten Dateien verwaltet werden (FAQ-Einträge, Blogbeiträge, Produkte).
    • Varianten — benannte oder strukturierte Inhaltsalternativen:
      • eine String-Variante für A/B-Tests, saisonale Banner oder Funktion-Flags;
      • eine Objekt-Variante für CMS-Datensätze, benutzerspezifische Inhalte oder beliebige Inhalte, die über eine Reihe von Feldern adressiert werden (die früheren „dynamischen Datensätze").
    Frühere Versionen boten ein separates meta-Feld für datensatzbasierte Inhalte. Es wurde in variant zusammengeführt: Übergeben Sie ein Objekt an variant, anstatt meta zu verwenden.

    Selektor-Disambiguierung

    Ein Schlüssel kann beide Dimensionen gleichzeitig deklarieren (z. B. eine Sammlung, deren Elemente jeweils eine Variante haben). Sie werden in dieser Reihenfolge aufgelöst:

    plaintext
    variant → item

    So gibt { variant: "promo" } bei einem Variant-×-Item-Schlüssel alle Promo-Elemente als Array zurück, und das Hinzufügen von { item: 2 } grenzt es auf einen einzelnen Eintrag ein.