Автор:
    Aymeric PINEAU
    Дата створення:2026-06-12Останнє оновлення:2026-06-26

    Динамічні словники

    Intlayer підтримує два механізми для вираження контенту, що виходить за межі єдиного статичного словника на ключ. Кожен оголошується через поле метаданих верхнього рівня у файлі контенту; функція-обгортка не потрібна.

    Можливість Поле метаданих Селектор у useIntlayer
    Колекції item: N { item: N }
    Варіанти variant: "name" або variant: { … } { variant: "name" } або { variant: { … } }

    Обидва поєднуються з аргументом locale і підтримують вибіркове / відкладене завантаження через importMode.

    Коли що використовувати

    • Колекції — упорядкований список елементів, керованих в окремих файлах (записи FAQ, пости блогу, товари).
    • Варіанти — іменовані або структуровані альтернативи контенту:
      • рядковий варіант для A/B-тестів, сезонних банерів або feature-прапорців;
      • об'єктний варіант для записів CMS, контенту конкретного користувача або будь-якого контенту, адресованого набором полів (колишні «динамічні записи»).
    У попередніх версіях для контенту за записами було окреме поле meta. Його об'єднано з variant: передавайте variant об'єкт замість використання meta.

    Усунення неоднозначності селектора

    Ключ може оголошувати обидва виміри одночасно (наприклад, колекція, кожен елемент якої має варіант). Вони розв'язуються в порядку:

    plaintext
    variant → item

    Отже, { variant: "promo" } для ключа variant × item повертає всі promo-елементи як масив, а додавання { item: 2 } звужує результат до одного запису.

    ФорматувальникиКолекції