Автор:
    Создание: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 } сужает результат до одной записи.