inject حقن بيانات الأسلاف (بأسلوب الخيارات)
آخر تحديث: 2026-10-22
inject حقن بيانات الأسلاف (بأسلوب الخيارات)
يصرّح خيار inject بالتبعيات المطلوب حقنها: صيغة المصفوفة لا تضبط قيماً افتراضية، وصيغة الكائن تكتب from (تبديل المصدر) و default (القيمة الافتراضية).
| المجموعة | الخيارات: التركيب ومتنوع |
|---|---|
| النوع | خيار |
| النطاق | داخل المكوّن |
| إصدار Vue | 3.0+ |
| دعم SSR | مدعوم |
📝 الصيغة
export default {
inject: ["theme"],
// أو مع قيمة افتراضية
inject: {
theme: { from: "theme", default: "light" }
}
}⚙️ الوسائط
| value | مصفوفة (قائمة أسماء المفاتيح) أو كائن ({ from, default }) |
|---|
القيمة المُرجعة：تُعلَّق القيمة المحقونة على النسخة، وتُستخدم بـ this.xxx مباشرة في القالب/السكربت
▶ مثال
عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:
المخرجات：
Without a provider it shows 'Theme: light by default'.💡 نقاط مهمة
💡 نصيحة في صيغة الكائن يكون from هو اسم المفتاح الفعلي؛ وبعد الحقن يُصل إليه في هذا المكوّن باسم مفتاح الكائن.
⚠️ تحذير لا تكتب كائناً مشتركاً في القيمة الافتراضية (ستتشاركه النسخ المتعددة)؛ استخدم دالة مصنع أو فحص undefined.
ℹ️ ملاحظة تبقى الـ refs المحقونة تفاعلية؛ وتفك القوالب غلافها تلقائياً.
🏷️ التركيب ومتنوع ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س كيف تُختار بين صيغة المصفوفة والكائن؟
ج استخدم صيغة الكائن عند الحاجة لقيم افتراضية أو تبديل أسماء المفاتيح؛ والمصفوفة أقصر في السيناريوهات البسيطة.
س هل يحدث خطأ إذا لم يوفّر الأسلاف؟
ج صيغة المصفوفة تُعيد undefined (مع تنبيه في التطوير)؛ وصيغة الكائن تلجأ إلى default.
س هل يمكن حقن دوال؟
ج نعم، يوفّر السلف دالة (غالباً مع حالة readonly) ليستدعيها الأحفاد.
