إنشاء:2026-01-21آخر تحديث:2026-01-21

    حزمة intlayer

    حزمة intlayer هي المكتبة الأساسية في منظومة Intlayer. توفر الدوال والأنواع والأدوات الأساسية لإدارة المحتوى متعدد اللغات في تطبيقات JavaScript وTypeScript.

    التثبيت

    npm install intlayer
    yarn add intlayer
    pnpm add intlayer
    bun add intlayer

    الصادرات

    التكوين

    استيراد:

    import "intlayer";
    المتغير النوع الوصف الوثيقة ذات الصلة
    configuration IntlayerConfig كائن تكوين Intlayer. getConfiguration
    getConfiguration () => IntlayerConfig يعيد كائن تكوين Intlayer. (غير مستحسن: استخدم configuration بدلاً من ذلك) getConfiguration
    locales Locales[] قائمة جميع اللغات المدعومة. -
    requiredLocales Locales[] قائمة جميع اللغات المطلوبة. -
    defaultLocale Locales المحلية الافتراضية. -

    الأنواع

    استيراد:

    import "intlayer";
    النوع الوصف
    Dictionary نوع Dictionary المستخدم لتعريف بنية القاموس.
    DeclarationContent (مهمل) استخدم Dictionary<T> بدلاً من ذلك.
    IntlayerConfig النوع الذي يعرّف تكوين Intlayer.
    ContentNode عنصر في محتوى القاموس.
    Locale النوع الذي يمثل الـ locale.
    LocalesValues القيم الممكنة للـ locale.
    StrictModeLocaleMap خريطة للـ locales مع تحقق صارم من الأنواع.

    دوال المحتوى

    Import:

    import "intlayer";
    الدالة النوع الوصف الوثيقة ذات الصلة
    t / getTranslation Function يختار المحتوى بناءً على الـ locale الحالي. ترجمة
    enu / getEnumeration Function يختار المحتوى بناءً على الكمية. التعداد
    cond / getCondition Function يختار المحتوى بناءً على شرط منطقي. الشرط
    gender Function يختار المحتوى بناءً على الجنس. الجنس
    insert Function يُدرج القيم داخل سلسلة المحتوى. الإدراج
    nest / getNesting Function يُضمِّن قاموسًا آخر. nesting
    md Function يعالج محتوى Markdown. markdown
    html Function يعالج محتوى HTML. html
    file Function يتعامل مع محتوى الملفات. file
    getDictionary Function يعالج الكائنات التي تشبه القواميس (المفتاح، المحتوى). يعالج ترجمات t()، والتعدادات (enumerations)، وما إلى ذلك. -
    getIntlayer Function مبني على getDictionary، لكنه يحقن نسخة محسنة من القاموس مأخوذة من التصريح المولد. -

    أدوات التوطين

    استيراد:

    import "intlayer";
    الدالة النوع الوصف الوثيقة ذات الصلة
    getLocale Function يكتشف الـ locale من سلسلة نصية أو من مسار. getLocale
    getLocaleLang Function يحصل على جزء اللغة من الـ locale. getLocaleLang
    getLocaleName Function يحصل على اسم العرض للـ locale. getLocaleName
    getLocalizedPath Function يحوّل مسارًا قياسيًا إلى مسار محلي. getLocalizedPath
    getCanonicalPath Function يحوّل مسارًا محليًا إلى المسار الكانوني. getCanonicalPath
    getLocalizedUrl Function ينشئ URL محلي. getLocalizedUrl
    getMultilingualUrls Function ينشئ URLs لجميع اللغات المدعومة. getMultilingualUrls
    getPathWithoutLocale Function يزيل بادئة اللغة من المسار. getPathWithoutLocale
    getPrefix Function يحصل على بادئة اللغة من المسار. getPrefix
    getHTMLTextDir Function يحصل على اتجاه النص (LTR/RTL). getHTMLTextDir
    validatePrefix Function يتحقق من صحة بادئة اللغة. validatePrefix

    أدوات المتصفح

    استيراد:

    import "intlayer";
    الدالة النوع الوصف
    getBrowserLocale Function يكتشف اللغة المفضلة للمتصفح.
    getCookie Function يسترجع قيمة ملف تعريف الارتباط.
    getLocaleFromStorage Function يسترجع اللغة من التخزين.
    setLocaleInStorage Function يحفظ اللغة في التخزين.

    أدوات التنسيق

    استيراد:

    import "intlayer";
    الدالة الوصف
    number يُنسق رقمًا.
    currency يُنسق قيمة عملة.
    percentage يُنسق نسبة مئوية.
    compact يُنسق رقمًا بصيغة مضغوطة.
    date يُنسق تاريخًا.
    relativeTime يُنسق الوقت النسبي.
    units يُنسق قيمة مع وحدات.
    Intl كائن Intl القياسي.
    لماذا Intlayer؟