Получайте уведомления о предстоящих релизах Intlayer
    Создание:2024-08-11Последнее обновление:2025-06-29

    Документация: функция getHTMLTextDir в intlayer

    Описание

    Функция getHTMLTextDir определяет направление текста (ltr, rtl или auto) на основе переданного локали. Она предназначена для помощи разработчикам в установке атрибута dir в HTML для правильного отображения текста.

    Параметры

    • locale?: Locales

      • Описание: Строка локали (например, Locales.ENGLISH, Locales.ARABIC), используемая для определения направления текста.
      • Тип: Locales (необязательно)

    Возвращаемое значение

    • Тип: Dir ('ltr' | 'rtl' | 'auto')
    • Описание: Направление текста, соответствующее локали:
      • 'ltr' для языков с направлением слева направо.
      • 'rtl' для языков с направлением справа налево.
      • 'auto' если локаль не распознана.

    Пример использования

    Определение направления текста

    typescript
    import { getHTMLTextDir } from "intlayer";getHTMLTextDir(Locales.ENGLISH); // Вывод: "ltr"getHTMLTextDir(Locales.FRENCH); // Вывод: "ltr"getHTMLTextDir(Locales.ARABIC); // Вывод: "rtl"

    Особые случаи

    • Локаль не указана:

      • Функция возвращает 'auto', если locale равен undefined.
    • Неизвестная локаль:

      • Для нераспознанных локалей функция по умолчанию возвращает 'auto'.

    Использование в компонентах:

    Функция getHTMLTextDir может использоваться для динамической установки атрибута dir в HTML-документе для правильного отображения текста в зависимости от локали.

    tsx
    import type { FC } from "react";import { getHTMLTextDir, type Locales } from "intlayer";export const HTMLLayout: FC<PropsWithChildren<{ locale: Locales }>> = ({  children,  locale,}) => (  <html dir={getHTMLTextDir(locale)} locale={locale}>    <body>{children}</body>  </html>);

    В приведённом выше примере атрибут dir динамически устанавливается в зависимости от локали.

    История документации

    • 5.5.10 - 2025-06-29: Инициализация истории
    Получайте уведомления о предстоящих релизах Intlayer