تحدد دالة 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 غير معرفة.
اللغة غير المعروفة:
- بالنسبة للغات غير المعروفة، تقوم الدالة بافتراض القيمة '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 بشكل ديناميكي بناءً على اللغة.

لماذا Intlayer؟

تاريخ الإصدارات

التوثيق: دالة getHTMLTextDir في intlayer

الوصف