المؤلف:
    Aymeric PINEAU
    إنشاء:2026-01-21آخر تحديث:2026-01-21

    حزمة intlayer

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

    التثبيت

    bash
    npm install intlayer

    الصادرات

    التكوين

    استيراد:

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

    الأنواع

    استيراد:

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

    دوال المحتوى

    Import:

    tsx
    import "intlayer";
    الدالةالنوعالوصفالوثيقة ذات الصلة
    t / getTranslationFunctionيختار المحتوى بناءً على الـ locale الحالي.ترجمة
    enu / getEnumerationFunctionيختار المحتوى بناءً على الكمية.التعداد
    cond / getConditionFunctionيختار المحتوى بناءً على شرط منطقي.الشرط
    genderFunctionيختار المحتوى بناءً على الجنس.الجنس
    insertFunctionيُدرج القيم داخل سلسلة المحتوى.الإدراج
    nest / getNestingFunctionيُضمِّن قاموسًا آخر.nesting
    mdFunctionيعالج محتوى Markdown.markdown
    htmlFunctionيعالج محتوى HTML.html
    fileFunctionيتعامل مع محتوى الملفات.file
    getDictionaryFunctionيعالج الكائنات التي تشبه القواميس (المفتاح، المحتوى). يعالج ترجمات t()، والتعدادات (enumerations)، وما إلى ذلك.-
    getIntlayerFunctionمبني على getDictionary، لكنه يحقن نسخة محسنة من القاموس مأخوذة من التصريح المولد.-

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

    استيراد:

    tsx
    import "intlayer";
    الدالةالنوعالوصفالوثيقة ذات الصلة
    getLocaleFunctionيكتشف الـ locale من سلسلة نصية أو من مسار.getLocale
    getLocaleLangFunctionيحصل على جزء اللغة من الـ locale.getLocaleLang
    getLocaleNameFunctionيحصل على اسم العرض للـ locale.getLocaleName
    getLocalizedPathFunctionيحوّل مسارًا قياسيًا إلى مسار محلي.getLocalizedPath
    getCanonicalPathFunctionيحوّل مسارًا محليًا إلى المسار الكانوني.getCanonicalPath
    getLocalizedUrlFunctionينشئ URL محلي.getLocalizedUrl
    getMultilingualUrlsFunctionينشئ URLs لجميع اللغات المدعومة.getMultilingualUrls
    getPathWithoutLocaleFunctionيزيل بادئة اللغة من المسار.getPathWithoutLocale
    getPrefixFunctionيحصل على بادئة اللغة من المسار.getPrefix
    comparePathsFunctionيقارن بين مسارين مع تجاهل اللغة (locale).comparePaths
    normalizePathFunctionيقوم بتسوية مسار ليكون مستقلاً عن اللغة.comparePaths
    getHTMLTextDirFunctionيحصل على اتجاه النص (LTR/RTL).getHTMLTextDir
    validatePrefixFunctionيتحقق من صحة بادئة اللغة.validatePrefix

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

    استيراد:

    tsx
    import "intlayer";
    الدالةالنوعالوصف
    getBrowserLocaleFunctionيكتشف اللغة المفضلة للمتصفح.
    getCookieFunctionيسترجع قيمة ملف تعريف الارتباط.
    getLocaleFromStorageFunctionيسترجع اللغة من التخزين.
    setLocaleInStorageFunctionيحفظ اللغة في التخزين.

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

    استيراد:

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