تلقي إشعارات حول الإصدارات القادمة من 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 غير معرفة.
    • اللغة غير المعروفة:

      • بالنسبة للغات غير المعروفة، تقوم الدالة بافتراض القيمة '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