استخدم مساعدك المفضل للملخص واستخدم هذه الصفحة والموفر AI الذي تريده
هذه الوثيقة غير محدثة، تم تحديث النسخة الأساسية في 22 أغسطس 2026.
الانتقال إلى الوثيقة الإنجليزيةتاريخ الإصدارات
- "إضافة منسقات vue"v5.8.020/8/2025
- "إضافة توثيق المنسقات"v5.8.018/8/2025
- "إضافة توثيق منسق القوائم"v5.8.020/8/2025
- "إضافة أدوات Intl إضافية (DisplayNames، Collator، PluralRules)"v5.8.020/8/2025
- "إضافة أدوات التعامل مع اللغة (getLocaleName، getLocaleLang، getLocaleFromPath، إلخ)"v5.8.020/8/2025
- "إضافة أدوات التعامل مع المحتوى (getContent، getTranslation، getIntlayer، إلخ)"v5.8.020/8/2025
تمت ترجمة محتوى هذه الصفحة باستخدام الذكاء الاصطناعي.
اعرض آخر نسخة المحتوى الأصلي باللغة الإنكليزيةإذا كان لديك فكرة لتحسين هذه الوثيقة، فلا تتردد في المساهمة من خلال تقديم طلب سحب على GitHub.
رابط GitHub للتوثيقنسخ الـ Markdown من المستند إلى الحافظة
أدوات تنسيق Intlayer
نظرة عامة
يوفر Intlayer مجموعة من المساعدين الخفيفين المبنيين على واجهات برمجة التطبيقات الأصلية Intl، بالإضافة إلى غلاف Intl مخزن مؤقت لتجنب إنشاء أدوات تنسيق ثقيلة بشكل متكرر. هذه الأدوات مدركة تمامًا للغة ويمكن استخدامها من الحزمة الرئيسية intlayer.
Intl المخزن مؤقتًا
الـ Intl المصدر هو غلاف رقيق مخزن مؤقت حول الـ Intl العالمي. يقوم بتخزين نسخ من NumberFormat، DateTimeFormat، RelativeTimeFormat، ListFormat، DisplayNames، Collator، و PluralRules، مما يتجنب إعادة بناء نفس أداة التنسيق مرارًا وتكرارًا.
نظرًا لأن إنشاء أداة التنسيق مكلف نسبيًا، فإن هذا التخزين المؤقت يحسن الأداء دون تغيير السلوك. الغلاف يعرض نفس واجهة برمجة التطبيقات Intl الأصلية، لذا فإن الاستخدام متطابق.
إذا لم يكن Intl.DisplayNames متاحًا في البيئة، يتم طباعة تحذير واحد مخصص للمطور فقط (فكر في استخدام polyfill).
أدوات اللغة
getLocaleFromPath(inputUrl)
نسخ الكود إلى الحافظة
getPathWithoutLocale(inputUrl, locales?)
يزيل جزء اللغة من عنوان URL أو مسار:
- inputUrl: سلسلة عنوان URL الكاملة أو مسار المعالجة
- locales: مصفوفة اختيارية من اللغات المدعومة (افتراضيًا إلى اللغات المُعدة)
- returns: عنوان URL بدون جزء اللغة
getLocalizedUrl(url, currentLocale, locales?, defaultLocale?, prefixDefault?)
نسخ الكود إلى الحافظة
getHTMLTextDir(locale?)
يعيد اتجاه النص للغة معينة:
نسخ الكود إلى الحافظة
أدوات معالجة المحتوى
getContent(node, nodeProps, locale?)
نسخ الكود إلى الحافظة
getTranslation(languageContent, locale?, fallback?)
يستخرج المحتوى للغة معينة من كائن محتوى متعدد اللغات:
- languageContent: كائن يربط اللغات بالمحتوى
- locale: اللغة المستهدفة (الافتراضي هو اللغة الافتراضية المُعدة)
- fallback: ما إذا كان يجب الرجوع إلى اللغة الافتراضية (الافتراضي هو true)
getIntlayer(dictionaryKey, locale?, plugins?)
نسخ الكود إلى الحافظة
getIntlayerAsync(dictionaryKey, locale?, plugins?)
يسترجع المحتوى بشكل غير متزامن من قاموس بعيد:
نسخ الكود إلى الحافظة
أدوات التنسيق
جميع الأدوات التالية مُصدرة من intlayer.
percentage(value, options?)
نسخ الكود إلى الحافظة
ميزات Intl إضافية
number(value, options?)
تنسيق قيمة رقمية باستخدام التجميع والفواصل العشرية الموجهة للغة.
- value:
number | string - options:
Intl.NumberFormatOptions & { locale?: LocalesValues }
نسخ الكود إلى الحافظة
percentage(value, options?)
تنسّق رقماً كسلسلة نسبة مئوية. يتم تطبيع القيم الأكبر من 1 (على سبيل المثال، 25 → 25%، 0.25 → 25%).
- value:
number | string - options:
Intl.NumberFormatOptions & { locale?: LocalesValues }
نسخ الكود إلى الحافظة
currency(value, options?)
تنسيق قيمة كعملة محلية. القيمة الافتراضية هي USD.
- value:
number | string - options:
Intl.NumberFormatOptions & { locale?: LocalesValues }- Common:
currency,currencyDisplay("symbol" | "code" | "name")
- Common:
نسخ الكود إلى الحافظة
date(date, optionsOrPreset?)
تنسيق قيمة التاريخ/الوقت.
- date:
Date | string | number - optionsOrPreset:
Intl.DateTimeFormatOptions & { locale?: LocalesValues }أو preset:"short" | "long" | "dateOnly" | "timeOnly" | "full"
نسخ الكود إلى الحافظة
relativeTime(from, to?, options?)
تنسيق الوقت النسبي بين لحظتين.
- from:
Date | string | number - to:
Date | string | number(الافتراضيnew Date()) - options:
{ locale?, unit?, numeric?, style? }
نسخ الكود إلى الحافظة
units(value, options?)
تنسيق قيمة رقمية مع وحدة.
- value:
number | string - options:
Intl.NumberFormatOptions & { locale?: LocalesValues }- Common:
unit(على سبيل المثال،"kilometer"،"byte"),unitDisplay("short" | "narrow" | "long")
- Common:
نسخ الكود إلى الحافظة
compact(value, options?)
تنسيق رقم باستخدام الترميز المضغوط.
- value:
number | string - options:
Intl.NumberFormatOptions & { locale?: LocalesValues }
نسخ الكود إلى الحافظة
list(values, options?)
تنسيق مصفوفة إلى سلسلة قائمة محلية.
- values:
(string | number)[] - options:
Intl.ListFormatOptions & { locale?: LocalesValues }- Common:
type("conjunction" | "disjunction" | "unit"),style("long" | "short" | "narrow")
- Common:
نسخ الكود إلى الحافظة
Cached Intl
الـ Intl المُصدَّر من intlayer هو غلاف مُخزّن مؤقتاً حول الـ Intl العام. يقوم بحفظ نسخ من instances المُنسِّقات (NumberFormat، DateTimeFormat، إلخ.) لتجنب بنائها بشكل متكرر، مما يحسّن الأداء.
نسخ الكود إلى الحافظة
ميزات Intl إضافية
Intl.DisplayNames
للحصول على الأسماء المحلية للغات والمناطق والعملات والنصوص:
نسخ الكود إلى الحافظة
Intl.Collator
لمقارنة وترتيب السلاسل النصية مع الوعي بالإعدادات المحلية:
نسخ الكود إلى الحافظة
Intl.PluralRules
لتحديد أشكال الجمع في لغات مختلفة:
نسخ الكود إلى الحافظة
أدوات المناطق الإقليمية
list(values, options?)
أمثلة:
نسخ الكود إلى الحافظة
getLocaleLang(locale?)
استخراج رمز اللغة من سلسلة نصية للإعدادات المحلية:
نسخ الكود إلى الحافظة
getLocaleFromPath(inputUrl)
استخراج جزء اللغة من عنوان URL أو مسار:
نسخ الكود إلى الحافظة
getPathWithoutLocale(inputUrl, locales?)
يزيل جزء اللغة من عنوان URL:
نسخ الكود إلى الحافظة
getLocalizedUrl(url, currentLocale, locales?, defaultLocale?, prefixDefault?)
ينشئ عنوان URL موطن:
نسخ الكود إلى الحافظة
getHTMLTextDir(locale?)
يعيد اتجاه النص للغة معينة:
نسخ الكود إلى الحافظة
أدوات معالجة المحتوى
React
مكونات العميل:
نسخ الكود إلى الحافظة
getTranslation(languageContent, locale?, fallback?)
استخراج المحتوى لمحلية معينة:
نسخ الكود إلى الحافظة
Vue
مكونات العميل:
نسخ الكود إلى الحافظة
ملاحظات
- جميع المساعدات تقبل مدخلات
string؛ يتم تحويلها داخليًا إلى أرقام أو تواريخ. - يتم تعيين اللغة الافتراضية إلى
internationalization.defaultLocaleالمُكوّن لديك في حالة عدم توفيره. - هذه الأدوات عبارة عن أغلفة رقيقة؛ للتنسيق المتقدم، قم بتمرير خيارات
Intlالقياسية.
