Документация: 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