Документация: 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 { getHTMLTextDir } from "intlayer";
    
    export const HTMLLayout = ({ children, locale }) => (
      <html dir={getHTMLTextDir(locale)} locale={locale}>
        <body>{children}</body>
      </html>
    );
    

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

    Если у вас есть идея по улучшению этой документации, не стесняйтесь внести свой вклад, подав запрос на вытягивание на GitHub.

    Ссылка на документацию GitHub