props استقبال بيانات المكوّن الأب
آخر تحديث: 2026-10-22
props استقبال بيانات المكوّن الأب
تصريح props يحدد الخصائص التي يستقبلها المكوّن خارجياً، ويدعم الاختصار بالمصفوفة والصيغة الكائنية للنوع والإلزام والقيمة الافتراضية.
| المجموعة | الخيارات: الحالة |
|---|---|
| النوع | خيار |
| النطاق | داخل المكوّن |
| إصدار Vue | 3.0+ |
| دعم SSR | مدعوم |
📝 الصيغة
export default {
props: {
title: { type: String, required: true },
count: { type: Number, default: 0 }
}
}⚙️ الوسائط
| value | مصفوفة أو كائن: الصيغة الكائنية تكتب type/required/default/validator |
|---|
القيمة المُرجعة：القيم الممررة من المكوّن الأب، للقراءة فقط (تدفق بيانات باتجاه واحد)
▶ مثال
عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:
المخرجات：
Shows 'Greeting (3 items)'.💡 نقاط مهمة
⚠️ تحذير تدفق بيانات باتجاه واحد: لا يستطيع المكوّن الابن تعديل الـ prop مباشرة، وعند الحاجة للتغيير أصدر حدثاً بـ emit لإبلاغ الأب.
💡 نصيحة القيم الافتراضية للكائنات/المصفوفات يجب أن تكون دوال مصنع: default: () => [] وليس default: [].
ℹ️ ملاحظة القيم الممررة بـ kebab-case تُطابق التصريح بـ camelCase: مرّر :post-title وصرّح بـ postTitle.
🏷️ الحالة ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س ماذا يحدث إذا عدّل المكوّن الابن الـ prop؟
ج تُصدر بيئة التطوير تحذيراً، ويُكتب التغيير فوقه عند إعادة تصيير الأب — الأصح إبلاغ الأب عبر emit ليعدّله.
س لماذا يظهر تحذير عند كتابة القيمة الافتراضية ككائن؟
ج ستتشارك النسخ المتعددة الكائن نفسه؛ استخدم دالة المصنع () => ({}) لتحصل كل نسخة على نسخة جديدة.
س هل يمكن مراقبة تغيّر الـ prop؟
ج نعم: watch: { title(newVal) { ... } } أو اشتف منه بـ computed.
