Автор:
    Aymeric PINEAU
    Создание:2026-01-21Последнее обновление:2026-01-21

    Пакет intlayer

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

    Установка

    bash
    npm install intlayer

    Экспорт

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

    Импорт:

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

    Типы

    Импорт:

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

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

    Импорт:

    tsx
    import "intlayer";
    ФункцияТипОписаниеСвязанный документ
    t / getTranslationFunctionВыбирает контент в зависимости от текущей локали.translation
    enu / getEnumerationFunctionВыбирает контент в зависимости от количества.enumeration
    cond / getConditionFunctionВыбирает контент в зависимости от булевого условия.условие
    genderFunctionВыбирает контент в зависимости от пола.пол
    insertFunctionВставляет значения в строку контента.вставка
    nest / getNestingFunctionВкладывает другой словарь.nesting
    mdFunctionОбрабатывает markdown-контент.markdown
    htmlFunctionОбрабатывает HTML-контент.html
    fileFunctionОбрабатывает содержимое файла.file
    getDictionaryFunctionОбрабатывает объекты, похожие на словари (ключ, содержимое). Обрабатывает переводы t(), перечисления и т. д.getDictionary
    getDictionaryAsyncFunctionЗагружает отдельный фрагмент локали словаря из карты загрузчиков по локалям, затем обрабатывает его.getDictionaryAsync
    getIntlayerFunctionОснован на getDictionary, но внедряет оптимизированную версию словаря из сгенерированного объявления.getIntlayer
    getIntlayerAsyncFunctionАсинхронный аналог getIntlayer, загружающий только запрошенную локаль. Для метаданных, загрузчиков, серверных функций.getIntlayerAsync

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

    Импорт:

    tsx
    import "intlayer";
    ФункцияТипОписаниеСвязанная документация
    getLocaleFunctionОпределяет локаль по строке или по пути.getLocale
    getLocaleLangFunctionВозвращает языковую часть локали.getLocaleLang
    getLocaleNameFunctionВозвращает отображаемое имя локали.getLocaleName
    getLocalizedPathFunctionПреобразует канонический путь в локализованный.getLocalizedPath
    getCanonicalPathFunctionПреобразует локализованный путь в канонический.getCanonicalPath
    getLocalizedUrlFunctionГенерирует локализованный URL.getLocalizedUrl
    getMultilingualUrlsFunctionГенерирует URL для всех поддерживаемых локалей.getMultilingualUrls
    getPathWithoutLocaleFunctionУдаляет префикс локали из пути.getPathWithoutLocale
    getPrefixFunctionПолучает префикс локали из пути.getPrefix
    comparePathsFunctionСравнивает два пути, игнорируя локаль.comparePaths
    normalizePathFunctionНормализует путь в независимый от локали.comparePaths
    getHTMLTextDirFunctionОпределяет направление текста (LTR/RTL).getHTMLTextDir
    validatePrefixFunctionПроверяет префикс локали.validatePrefix

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

    Импорт:

    tsx
    import "intlayer";
    ФункцияТипОписание
    getBrowserLocaleFunctionОпределяет предпочтительную локаль браузера.
    getCookieFunctionПолучает значение cookie.
    getLocaleFromStorageFunctionПолучает локаль из хранилища.
    setLocaleInStorageFunctionСохраняет локаль в хранилище.

    Форматтеры

    Импорт:

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