app.directive() التسجيل العام للتوجيهات
آخر تحديث: 2026-10-22
app.directive() التسجيل العام للتوجيهات
تُسجّل app.directive() توجيهاً مخصصاً عاماً: يُستخدم بالشكل v-xxx في قوالب أي مكوّن، وهو مناسب لسلوكيات شائعة كالأذونات والنقر في الخارج.
| المجموعة | واجهة API العامة |
|---|---|
| النوع | API |
| النطاق | عام |
| إصدار Vue | 3.0+ |
| دعم SSR | مدعوم |
📝 الصيغة
app.directive("focus", {
mounted(el) { el.focus() }
})⚙️ الوسائط
| name, directive? | اسم التوجيه (يُحذف البادئة عند استخدامه بـ v-) + تعريف التوجيه (يتضمن خطافات mounted/updated وغيرها) |
|---|
القيمة المُرجعة：نسخة التطبيق (قابلة للتسلسل)
▶ مثال
عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:
المخرجات：
The input receives focus automatically.💡 نقاط مهمة
ℹ️ ملاحظة خطافات التوجيه تحمل أسماء دورة الحياة نفسها: created/beforeMount/mounted/beforeUpdate/updated/beforeUnmount/unmounted.
💡 نصيحة ما يمكن تغليفه كدالة تركيبية (composable) فاستخدمها أولاً؛ التوجيهات مناسبة لسلوك DOM خالص واستخدام واسع.
⚠️ تحذير وسائط التوجيه ومُعدّلاته تُكتب في كائن binding، وانتبه عند فك القيم.
🏷️ واجهة API العامة ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س كيف تُختار بينه وبين الدوال التركيبية؟
ج إن احتجت التلاعب المباشر بالعنصر مع استخدام واسع → توجيه؛ وإن احتجت حالة ومنطقاً → دالة تركيبية.
س هل تستقبل التوجيهات وسائط؟
ج نعم: v-demo:arg.mod="value"، وتُقرأ من binding.arg/modifiers/value.
س كيف تُكتب التوجيهات المحلية؟
ج تُعلَّن داخل المكوّن بخيار directives، وتكون متاحة في قالب ذلك المكوّن فقط.
