استخدم مساعدك المفضل للملخص واستخدم هذه الصفحة والموفر AI الذي تريده
تاريخ الإصدارات
- "إضافة توثيق خطافات useIntlayer و useDictionary و useLocale والبرمجية الوسيطة وأدوات التنسيق"v9.5.519/9/2026
- "توثيق موحد لجميع الصادرات"v8.0.021/1/2026
تمت ترجمة محتوى هذه الصفحة باستخدام الذكاء الاصطناعي.
اعرض آخر نسخة المحتوى الأصلي باللغة الإنكليزيةإذا كان لديك فكرة لتحسين هذه الوثيقة، فلا تتردد في المساهمة من خلال تقديم طلب سحب على GitHub.
رابط GitHub للتوثيقنسخ الـ Markdown من المستند إلى الحافظة
حزمة astro-intlayer
توفر حزمة astro-intlayer الأدوات اللازمة لدمج Intlayer في تطبيقات Astro. حيث تقوم بتهيئة التوجيه المستند إلى اللغة، وإدارة القواميس، وإعادة كتابة الصفحات أثناء البناء، وبرمجيات الطلب الوسيطة، والخطافات للوصول إلى المحتوى متعدد اللغات عبر مكونات .astro المعروضة على الخادم وسكربتات العميل.
التثبيت
نسخ الكود إلى الحافظة
الصادرات
التكامل
توفر حزمة astro-intlayer تكامل Astro يقوم بإعداد Intlayer في مشروعك.
استيراد:
نسخ الكود إلى الحافظة
أو استيراد افتراضي في astro.config.mjs:
نسخ الكود إلى الحافظة
افتح الجدول في نافذة منبثقة لعرض جميع محتويات البيانات بوضوح
| الدالة | الوصف | المستند ذو الصلة |
|---|---|---|
intlayer | تكامل Astro يجهز القواميس، ويهيئ إضافات Vite (الأسماء المستعارة، وكيل التوجيه، التقليم)، ويسجل تلقائيًا برمجية الطلب الوسيطة، ويُخرج الصفحات المعروضة مسبقًا عبر عناوين URL معاد كتابتها. | intlayer |
الخطافات (الخادم والعميل)
استيراد:
نسخ الكود إلى الحافظة
افتح الجدول في نافذة منبثقة لعرض جميع محتويات البيانات بوضوح
| الخطاف | الوصف | المستند ذو الصلة |
|---|---|---|
useIntlayer | يختار قاموسًا واحدًا بواسطة مفتاحه ويُرجع محتواه المترجم. في واجهة .astro، يقرأ لغة الطلب من Astro.locals. وفي كود <script>، يقرأ من متجر العميل. | useIntlayer |
useDictionary | يحول كائن قاموس ويُرجع المحتوى للغة المحددة. يعمل في واجهة المكونات وسكربتات العميل. | useDictionary |
useLocale | يُرجع اللغة الحالية، واللغة الافتراضية، واللغات المتاحة، ودالة لتحديث اللغة. | useLocale |
البرمجية الوسيطة (astro-intlayer/middleware)
استيراد:
نسخ الكود إلى الحافظة
افتح الجدول في نافذة منبثقة لعرض جميع محتويات البيانات بوضوح
| التصدير | النوع | الوصف | المستند ذو الصلة |
|---|---|---|---|
onRequest | MiddlewareHandler | برمجية وسيطة لـ Astro تكتشف لغة الطلب وتربط Astro.locals.intlayer. يتم تسجيلها تلقائيًا بواسطة intlayer()، أو استيرادها يدويًا لدمجها. | onRequest |
الأدوات المساعدة
استيراد:
نسخ الكود إلى الحافظة
افتح الجدول في نافذة منبثقة لعرض جميع محتويات البيانات بوضوح
| الدالة | الوصف | المستند ذو الصلة |
|---|---|---|
getIntlayerLocals | دالة مساعدة لاسترداد كائن IntlayerLocals الحالي من نطاق تخزين الطلب خارج Astro.locals. | - |
أدوات العميل (astro-intlayer/client)
استيراد:
نسخ الكود إلى الحافظة
عند استيرادها في المتصفح أو داخل وسوم <script> للعميل، يتم تعيين astro-intlayer تلقائيًا إلى astro-intlayer/client (المدعوم بواسطة vanilla-intlayer)، مما يوفر أدوات استرداد القواميس والاشتراك في المتجر وحفظ اللغة على جانب العميل.
أدوات التنسيق (astro-intlayer/format)
استيراد:
نسخ الكود إلى الحافظة
افتح الجدول في نافذة منبثقة لعرض جميع محتويات البيانات بوضوح
| الخطاف | الوصف |
|---|---|
useIntl | يُرجع مثيل Intl مرتبطًا بلغة الطلب أو العميل مع إمكانيات التخزين المؤقت والاشتراك. |
useDate | يُرجع دالة لتنسيق التاريخ مرتبطة مسبقًا باللغة الحالية (Intl.DateTimeFormat). |
useNumber | يُرجع دالة لتنسيق الأرقام مرتبطة مسبقًا باللغة الحالية (Intl.NumberFormat). |
useCurrency | يُرجع دالة لتنسيق العملة مرتبطة مسبقًا باللغة الحالية. |
usePercentage | يُرجع دالة لتنسيق النسبة المئوية مرتبطة مسبقًا باللغة الحالية. |
useRelativeTime | يُرجع دالة لتنسيق الوقت النسبي مرتبطة مسبقًا باللغة الحالية (Intl.RelativeTimeFormat). |
useList | يُرجع دالة لتنسيق القوائم مرتبطة مسبقًا باللغة الحالية (Intl.ListFormat). |
useUnit | يُرجع دالة لتنسيق الوحدات مرتبطة مسبقًا باللغة الحالية. |
useCompact | يُرجع دالة لتنسيق الأرقام المدمجة مرتبطة مسبقًا باللغة الحالية (مثل 1.5K). |
أدوات HTML (astro-intlayer/html)
استيراد:
نسخ الكود إلى الحافظة
افتح الجدول في نافذة منبثقة لعرض جميع محتويات البيانات بوضوح
| التصدير | النوع | الوصف |
|---|---|---|
renderHTML | Function | دالة مساعدة مستقلة لعرض عُقد HTML. |
useHTML | Hook | خطاف للحصول على سياق وإعدادات مزود HTML. |
useHTMLRenderer | Hook | خطاف للحصول على دالة عرض HTML مهيأة مسبقًا. |
أدوات Markdown (astro-intlayer/markdown)
استيراد:
نسخ الكود إلى الحافظة
افتح الجدول في نافذة منبثقة لعرض جميع محتويات البيانات بوضوح
| التصدير | النوع | الوصف |
|---|---|---|
compileMarkdown | Function | يترجم سلاسل markdown إلى تمثيل منظم. |
renderMarkdown | Function | يعرض محتوى markdown في عُقد إخراج. |
parseMarkdown | Function | يحلل محتوى markdown الخام إلى شجرة بناء الجملة المجردة (AST). |
useMarkdown | Hook | خطاف للحصول على سياق مزود markdown. |
useMarkdownRenderer | Hook | خطاف للحصول على دالة عرض Markdown مهيأة مسبقًا. |
الأنواع
استيراد:
نسخ الكود إلى الحافظة
افتح الجدول في نافذة منبثقة لعرض جميع محتويات البيانات بوضوح
| النوع | الوصف |
|---|---|
IntlayerLocals | الكائن المرفق بـ Astro.locals.intlayer والذي يحتوي على locale و defaultLocale و availableLocales. |
UseLocaleProps | خصائص التهيئة الاختيارية المقبولة بواسطة useLocale(). |
UseLocaleResult | نوع القيمة المرجعة لـ useLocale()، والذي يوفر خصائص اللغة وطرق التحديث. |
