إنشاء:2026-08-24آخر تحديث:2026-08-24
استخدم هذه الصفحة والموفر AI الذي تريدهChatGPTClaudeDeepSeekGoogle AI modeGeminiPerplexityMistralGrok
استخدم مساعدك المفضل للملخص واستخدم هذه الصفحة والموفر AI الذي تريده
تاريخ الإصدارات
- "توثيق موحّد لجميع الصادرات"v9.4.024/8/2026
تمت ترجمة محتوى هذه الصفحة باستخدام الذكاء الاصطناعي.
اعرض آخر نسخة المحتوى الأصلي باللغة الإنكليزيةتعديل هذه الوثيقة
إذا كان لديك فكرة لتحسين هذه الوثيقة، فلا تتردد في المساهمة من خلال تقديم طلب سحب على GitHub.
رابط GitHub للتوثيقنسخ
نسخ الـ Markdown من المستند إلى الحافظة
حزمة elysia-intlayer
توفر حزمة elysia-intlayer ملحقًا لتطبيقات Elysia للتعامل مع التدويل (internationalization). تقوم باكتشاف الـ locale الخاص بالمستخدم وتحقن كائن intlayer في سياق المسار.
التثبيت
bash
نسخ الكود
نسخ الكود إلى الحافظة
elysiaهي peer dependency (>=1.0.0). ويستهدف Elysia بيئة تشغيل Bun.
الصادرات
الملحق
استيراد:
ts
نسخ الكود
نسخ الكود إلى الحافظة
اظهار جميع محتويات الجدول
افتح الجدول في نافذة منبثقة لعرض جميع محتويات البيانات بوضوح
| الدالة | الوصف | الوثيقة ذات الصلة |
|---|---|---|
intlayer | ملحق Elysia يدمج Intlayer في تطبيق Elysia الخاص بك. يتولى اكتشاف الـ locale من التخزين (الكوكيز، الرؤوس) ثم من Accept-Language، ويحقن كائن intlayer يعرض locale وt وgetIntlayer وgetDictionary في سياق المسار، ويهيّئ سياق الطلب عبر AsyncLocalStorage. | intlayer |
الوظائف
استيراد:
ts
نسخ الكود
نسخ الكود إلى الحافظة
اظهار جميع محتويات الجدول
افتح الجدول في نافذة منبثقة لعرض جميع محتويات البيانات بوضوح
| الدالة | الوصف | الوثيقة ذات الصلة |
|---|---|---|
t | دالة ترجمة عامة تسترجع المحتوى للـ locale الحالي في Elysia. تستخدم AsyncLocalStorage للوصول إلى سياق الطلب الذي يهيّئه المكوّن intlayer، وتعود إلى اللغة الافتراضية خارجه. يمكن الوصول إليها أيضًا عبر intlayer.t. | translation |
getIntlayer | يسترجع قاموسًا عبر مفتاحه من التصريح المُولَّد ويعيد محتواه للـ locale الحالي. نسخة محسّنة من getDictionary. يستخدم AsyncLocalStorage للوصول إلى سياق الطلب. يمكن الوصول إليه أيضًا عبر intlayer.getIntlayer. | - |
getDictionary | يعالج كائنات القواميس ويعيد المحتوى للـ locale الحالي. يعالج ترجمات t() والتعدادات وmarkdown وHTML وغيرها. يستخدم AsyncLocalStorage للوصول إلى سياق الطلب. يمكن الوصول إليه أيضًا عبر intlayer.getDictionary. | - |
الأنواع
استيراد:
ts
نسخ الكود
نسخ الكود إلى الحافظة
اظهار جميع محتويات الجدول
افتح الجدول في نافذة منبثقة لعرض جميع محتويات البيانات بوضوح
| النوع | الوصف |
|---|---|
IntlayerContext | شكل كائن intlayer المحقون في كل سياق مسار: locale، locale_storage، locale_detected، defaultLocale، t، getIntlayer، getDictionary. |
TranslateFunction | توقيع دالة الترجمة التي تحوّل locale map إلى المحتوى المطابق للـ locale الخاص بالطلب الحالي. |
الاستخدام
src/index.ts
نسخ الكود
نسخ الكود إلى الحافظة
تسجّل الإضافة سياقها عبرderiveعام، والذي يعطيه Elysia النوعPartial<{ intlayer: IntlayerContext }>. تكون القيمة موجودة دائماً وقت التشغيل للمسارات المسجَّلة بعد.use(intlayer())، لذا استخدم تأكيد عدم الفراغ (intlayer!.locale) — أو التسلسل الاختياري — لإرضاء TypeScript في الوضعstrict.
