Автор:
    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(), перечисления и т.д.-
    getIntlayerFunctionОсновано на getDictionary, но внедряет оптимизированную версию словаря из сгенерированного декларационного файла.-

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

    Импорт:

    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