Autor:
    Aymeric PINEAU
    Data utworzenia:2026-06-12Ostatnia aktualizacja:2026-06-26

    Słowniki dynamiczne

    Intlayer obsługuje dwa mechanizmy wyrażania treści wykraczającej poza pojedynczy statyczny słownik na klucz. Każdy jest deklarowany przez pole metadanych najwyższego poziomu w pliku treści; nie jest potrzebna żadna funkcja opakowująca.

    Funkcja Pole metadanych Selektor w useIntlayer
    Kolekcje item: N { item: N }
    Warianty variant: "name" lub variant: { … } { variant: "name" } lub { variant: { … } }

    Oba łączą się z argumentem locale i obsługują selektywne / leniwe ładowanie przez importMode.

    Kiedy czego używać

    • Kolekcje — uporządkowana lista elementów zarządzanych w osobnych plikach (wpisy FAQ, posty na blogu, produkty).
    • Warianty — nazwane lub strukturalne alternatywy treści:
      • wariant tekstowy do testów A/B, banerów sezonowych lub feature flag;
      • wariant obiektowy dla rekordów CMS, treści zależnej od użytkownika lub dowolnej treści adresowanej zestawem pól (dawne „rekordy dynamiczne").
    Wcześniejsze wersje udostępniały osobne pole meta dla treści indeksowanej rekordami. Zostało scalone z variant: przekaż do variant obiekt zamiast używać meta.

    Ujednoznacznianie selektora

    Klucz może deklarować obydwa wymiary jednocześnie (np. kolekcja, której elementy mają wariant). Są one rozwiązywane w kolejności:

    plaintext
    variant → item

    Zatem { variant: "promo" } dla klucza variant × item zwraca wszystkie elementy promo jako tablicę, a dodanie { item: 2 } zawęża wynik do pojedynczego wpisu.

    FormateryKolekcje