Создание:2026-01-21Последнее обновление:2026-01-21

    Пакет intlayer

    Пакет intlayer, это основная библиотека экосистемы Intlayer. Он предоставляет необходимые функции, типы и утилиты для управления многоязычным контентом в приложениях на JavaScript и TypeScript.

    Установка

    npm install intlayer
    yarn add intlayer
    pnpm add intlayer
    bun add intlayer

    Экспорт

    Конфигурация

    Импорт:

    import "intlayer";
    Переменная Тип Описание Связанный документ
    configuration IntlayerConfig Объект конфигурации Intlayer. getConfiguration
    getConfiguration () => IntlayerConfig Возвращает объект конфигурации Intlayer. (Устарело: используйте configuration вместо этого) getConfiguration
    locales Locales[] Список всех поддерживаемых локалей. -
    requiredLocales Locales[] Список всех обязательных локалей. -
    defaultLocale Locales Локаль по умолчанию. -

    Типы

    Импорт:

    import "intlayer";
    Тип Описание
    Dictionary Тип словаря, используемый для определения структуры словаря.
    DeclarationContent (Устарело) Используйте Dictionary<T> вместо этого.
    IntlayerConfig Тип, определяющий конфигурацию Intlayer.
    ContentNode Узел в содержимом словаря.
    Locale Тип, представляющий локаль.
    LocalesValues Возможные значения для локали.
    StrictModeLocaleMap Map локалей со строгой проверкой типов.

    Функции контента

    Импорт:

    import "intlayer";
    Функция Тип Описание Связанный документ
    t / getTranslation Function Выбирает контент в зависимости от текущей локали. translation
    enu / getEnumeration Function Выбирает контент в зависимости от количества. enumeration
    cond / getCondition Function Выбирает контент в зависимости от булевого условия. условие
    gender Function Выбирает контент в зависимости от пола. пол
    insert Function Вставляет значения в строку контента. вставка
    nest / getNesting Function Вкладывает другой словарь. nesting
    md Function Обрабатывает markdown-контент. markdown
    html Function Обрабатывает HTML-контент. html
    file Function Обрабатывает содержимое файла. file
    getDictionary Function Обрабатывает объекты, похожие на словари (ключ, содержимое). Обрабатывает переводы t(), перечисления и т.д. -
    getIntlayer Function Основано на getDictionary, но внедряет оптимизированную версию словаря из сгенерированного декларационного файла. -

    Утилиты локализации

    Импорт:

    import "intlayer";
    Функция Тип Описание Связанная документация
    getLocale Function Определяет локаль по строке или по пути. getLocale
    getLocaleLang Function Возвращает языковую часть локали. getLocaleLang
    getLocaleName Function Возвращает отображаемое имя локали. getLocaleName
    getLocalizedPath Function Преобразует канонический путь в локализованный. getLocalizedPath
    getCanonicalPath Function Преобразует локализованный путь в канонический. getCanonicalPath
    getLocalizedUrl Function Генерирует локализованный URL. getLocalizedUrl
    getMultilingualUrls Function Генерирует URL для всех поддерживаемых локалей. getMultilingualUrls
    getPathWithoutLocale Function Удаляет префикс локали из пути. getPathWithoutLocale
    getPrefix Function Получает префикс локали из пути. getPrefix
    getHTMLTextDir Function Определяет направление текста (LTR/RTL). getHTMLTextDir
    validatePrefix Function Проверяет префикс локали. validatePrefix

    Утилиты браузера

    Импорт:

    import "intlayer";
    Функция Тип Описание
    getBrowserLocale Function Определяет предпочтительную локаль браузера.
    getCookie Function Получает значение cookie.
    getLocaleFromStorage Function Получает локаль из хранилища.
    setLocaleInStorage Function Сохраняет локаль в хранилище.

    Форматтеры

    Импорт:

    import "intlayer";
    Функция Описание
    number Форматирует число.
    currency Форматирует значение валюты.
    percentage Форматирует процент.
    compact Форматирует число в компактной форме.
    date Форматирует дату.
    relativeTime Форматирует относительное время.
    units Форматирует значение с единицами.
    Intl Стандартный объект Intl.