ref مرجع القالب (ref)
آخر تحديث: 2026-10-22
ref مرجع القالب (ref)
تُسمّي السمة ref عنصرًا أو مكوّنًا للوصول إليه من الشيفرة عبر $refs أو ref()/useTemplateRef().
| المجموعة | المدمجات |
|---|---|
| النوع | سمة خاصة |
| النطاق | القالب |
| إصدار Vue | 3.0+ |
| دعم SSR | مدعوم |
📝 الصيغة
<input ref="inp">
<child-comp ref="child"></child-comp>⚙️ الوسائط
| props | اسم نصي (تُجمَع refs بالاسم نفسه تلقائيًا)؛ ويصبح مصفوفة داخل v-for |
|---|
▶ مثال
عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:
المخرجات：
The input is focused after mount.💡 نقاط مهمة
ℹ️ ملاحظة بنمط Composition: صرِّح عن ref(null) بالاسم نفسه، أو استخدم useTemplateRef في الإصدار 3.5 فأعلى.
⚠️ تحذير قيمته null قبل التركيب (mount) — تحقّق قبل الاستخدام.
💡 نصيحة فضّل الشيفرة المبنية على البيانات؛ واحجز refs للحالات التي تحتاج تركيزًا أو قياس أبعاد أو تركيب مكتبات.
🏷️ المدمجات ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س هل تتعارض السمة ref مع ref()؟
ج لا — السمة مجرد علامة، بينما ref() هي واجهة API التفاعلية.
س هل يمكن الإشارة إلى عدة عناصر؟
ج تعطي refs داخل v-for مصفوفات (دون ضمان الترتيب).
س متى يجب تجنّبها؟
ج تجنّبها إذا كانت الحالة والأحداث تكفي للتعبير عن المنطق.
