Creation:2026-01-21Last update:2026-01-21

    Пакет intlayer

    Пакет intlayer, це основна бібліотека екосистеми Intlayer. Він надає необхідні функції, типи та утиліти для керування багатомовним контентом у застосунках на JavaScript та TypeScript.

    Встановлення

    bash
    npm install intlayer

    Експорти

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

    Імпорт:

    tsx
    import "intlayer";
    Змінна Тип Опис Пов'язаний документ
    configuration IntlayerConfig Об'єкт конфігурації Intlayer. getConfiguration
    getConfiguration () => IntlayerConfig Повертає об'єкт конфігурації Intlayer. (Deprecated: Використовуйте configuration натомість) getConfiguration
    locales Locales[] Список усіх підтримуваних локалей. -
    requiredLocales Locales[] Список усіх обов'язкових локалей. -
    defaultLocale Locales Локаль за замовчуванням. -

    Типи

    Імпорт:

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

    Функції вмісту

    Імпорт:

    tsx
    import "intlayer";
    Функція Тип Опис Пов'язаний документ
    t / getTranslation Function Вибирає вміст залежно від поточної локалі. переклад
    enu / getEnumeration Function Вибирає вміст залежно від кількості. перерахування
    cond / getCondition Function Вибирає контент на основі булевої умови. умова
    gender Function Вибирає контент на основі гендера. гендер
    insert Function Вставляє значення у рядок контенту. вставлення
    nest / getNesting Function Вкладає інший словник. вкладення
    md Function Обробляє вміст у форматі Markdown. markdown
    html Function Обробляє HTML-вміст. html
    file Function Обробляє вміст файлу. file
    getDictionary Function Обробляє об'єкти, які виглядають як словники (ключ, вміст). Обробляє переклади t(), enumerations тощо. -
    getIntlayer Function Базується на getDictionary, але вставляє оптимізовану версію словника зі згенерованої декларації. -

    Локалізаційні утиліти

    Імпорт:

    tsx
    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

    Браузерні утиліти

    Імпорт:

    tsx
    import "intlayer";
    Функція Тип Опис
    getBrowserLocale Function Визначає переважний locale браузера.
    getCookie Function Отримує значення cookie.
    getLocaleFromStorage Function Отримує locale зі сховища.
    setLocaleInStorage Function Зберігає locale в сховище.

    Форматери

    Імпорт:

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