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

    حزمة next-intlayer

    توفّر حزمة next-intlayer الأدوات اللازمة لدمج Intlayer في تطبيقات Next.js. تدعم كلًا من App Router و Page Router، وتشمل ميدلوير للتوجيه بناءً على اللغة (locale-based routing).

    التثبيت

    npm install next-intlayer

    التصدير

    الوسيط (Middleware)

    استيراد:

    import "next-intlayer/middleware";
    الدالة الوصف المستند المرتبط
    intlayerMiddleware ميدلوير Next.js للتعامل مع التوجيه والإعادات بناءً على اللغة. يكتشف اللغة من الرؤوس/الكوكيز ويعيد التوجيه إلى مسار اللغة المناسب. intlayerMiddleware

    أدوات التهيئة

    استيراد:

    import "next-intlayer/server";
    الدالة الوصف المستند المرتبط
    withIntlayer مساعد غير متزامن لتغليف تكوين Next.js، يضمن تجهيز قواميس Intlayer قبل البناء. يقوم بتحضير ملفات المحتوى وإعداد ملحقات webpack/SWC. -
    withIntlayerSync مساعد متزامن لتغليف تكوين Next.js، مثالي للتكوينات التي لا يكون فيها الأسلوب غير المتزامن ممكنًا/مطلوبًا. لا يقوم بتحضير القواميس عند بدء الخادم. -

    الموفرون

    استيراد:

    import "next-intlayer";

    أو

    import "next-intlayer/server";
    المكوّن الوصف الوثيقة ذات الصلة
    IntlayerClientProvider مزود للمكونات على جهة العميل في App Router الخاص بـ Next.js. يغلّف IntlayerProvider من react-intlayer. -
    IntlayerServerProvider مزود للمكونات على جهة الخادم في Next.js (App Router). يوفر سياق اللغة (locale) على الخادم. -
    IntlayerServer غلاف على جهة الخادم لمحتوى Intlayer في App Router. يضمن التعامل الصحيح مع الـ locale في مكونات الخادم. -
    HTMLProvider مزود لإعدادات التدويل المتعلقة بـ HTML. يسمح بتجاوز المكونات لعلامات HTML. -
    HTMLRenderer يعرض محتوى HTML مع مكونات مخصصة. -
    MarkdownProvider مزود لسياق عرض Markdown. يسمح بتجاوز المكونات المخصصة لعناصر Markdown. -
    MarkdownRenderer يعرض محتوى Markdown مع مكونات مخصصة. -

    Hooks (جهة العميل)

    استيراد:

    import "next-intlayer";

    يعيد تصدير معظم الـ hooks من react-intlayer.

    Hook الوصف المستند ذو الصلة
    useIntlayer Hook على جانب العميل يختار قاموسًا واحدًا حسب مفتاحه ويُعيد محتواه. يستخدم الـ locale من السياق إذا لم يتم توفيره. useIntlayer
    useDictionary Hook يحوّل كائن القاموس ويُرجع المحتوى للـ locale الحالي. يعالج ترجمات t()، والتعدادات (enumerations)، وما إلى ذلك. useDictionary
    useDictionaryAsync Hook يتعامل مع القواميس غير المتزامنة. يقبل خريطة قواميس مبنية على Promise ويقوم بحلّها وفقًا للـ locale الحالي. -
    useDictionaryDynamic Hook يتعامل مع القواميس الديناميكية المحمّلة حسب المفتاح. يستخدم React Suspense داخليًا لحالات التحميل. -
    useLocale هوك على جانب العميل للحصول على اللغة الحالية ودالة لتعيينها. محسّن لـ Next.js App Router مع دعم التنقل. useLocale
    useRewriteURL هوك على جانب العميل لإدارة إعادة كتابة عناوين URL. يقوم تلقائيًا بتحديث عنوان URL إذا وُجدت قاعدة إعادة كتابة محلية أكثر ملاءمة. useRewriteURL
    useLocalePageRouter Hook مخصص لـ Next.js Page Router لإدارة الـ locale. يتعامل مع إعادة التوجيه وإعادة تحميل الصفحة عند تغيّر الـ locale. -
    useI18n Hook يوفّر دالة ترجمة t() للوصول إلى محتوى متداخل بواسطة مفتاح. يُحاكي نمط i18next/next-intl. useI18n
    useIntl هوك يوفر كائن Intl مرتبطًا بالـ locale. يقوم بحقن الـ locale الحالية تلقائيًا ويستخدم تخزينًا مؤقتًا محسنًا. -
    useLoadDynamic هوك لتحميل قواميس ديناميكية باستخدام React Suspense. يقبل مفتاحًا ووعدًا (promise)، ويخزن النتائج في ذاكرة مؤقتة. -
    useHTMLRenderer هوك للحصول على دالة عرض HTML مُكوّنة مسبقًا. -
    useMarkdownRenderer هوك للحصول على دالة عرض Markdown مُكوّنة مسبقًا. -

    الدوال (على الخادم)

    استيراد:

    import "next-intlayer/server";
    Function الوصف الوثيقة ذات الصلة
    t نسخة تعمل على جهة الخادم من دالة الترجمة لـ Next.js App Router. تُعيد ترجمة المحتوى متعدد اللغات بحسب الـ locale الخاص بالخادم. translation
    getLocale دالة مساعدة لاستخراج الـ locale الحالي من رؤوس (headers) وملفات تعريف الارتباط (cookies) في Next.js. مصممة لاستخدامها في Server Components، Server Actions، أو Route Handlers. -
    generateStaticParams تولد معلمات ثابتة لطرق Next.js الديناميكية بناءً على الـ locales المكوّنة. تُعيد مصفوفة من كائنات locale للـ pre-rendering. -
    locale دالة للحصول على أو تعيين الـ locale في سياق الخادم (App Router). توفر إدارة الـ locale في Server Components. -

    الأنواع

    استيراد:

    import "next-intlayer";
    النوع الوصف
    NextPageIntlayer نوع لصفحات Next.js مع دعم Intlayer. نوع عام يتضمن معامل locale.
    Next14PageIntlayer نوع لصفحات Next.js 14 مع دعم Intlayer.
    Next15PageIntlayer نوع لصفحات Next.js 15 مع دعم Intlayer.
    NextLayoutIntlayer نوع للتخطيطات (layouts) في Next.js مع دعم Intlayer. نوع عام يتضمن معامل locale.
    Next14LayoutIntlayer نوع لتخطيطات Next.js 14 مع دعم Intlayer.
    Next15LayoutIntlayer نوع لتخطيطات Next.js 15 مع دعم Intlayer.
    LocalParams نوع لمعلمات المسار في Next.js مع locale. كائن يحتوي على الخاصية locale.
    LocalPromiseParams نوع لمعلمات المسار في Next.js مع locale (الإصدار غير المتزامن). Promise تتحلل إلى كائن يحتوي على الخاصية locale.
    لماذا Intlayer؟