app.use() تثبيت الإضافات
آخر تحديث: 2026-10-22
app.use() تثبيت الإضافات
تُثبّت app.use() الإضافة: يمكن للإضافة تسجيل مكوّنات وتوجيهات عامة، أو حقن تبعيات، أو إضافة إلى إعدادات التطبيق (كالتوجيه وإدارة الحالة).
| المجموعة | واجهة API العامة |
|---|---|
| النوع | API |
| النطاق | عام |
| إصدار Vue | 3.0+ |
| دعم SSR | مدعوم |
📝 الصيغة
app.use(router)
app.use(pinia)
app.use(MyPlugin, { option: 1 })
⚙️ الوسائط
| plugin, ...options | الإضافة (كائن يحوي دالة install أو دالة) + خيارات إعداد اختيارية |
|---|
القيمة المُرجعة:نسخة التطبيق (قابلة للتسلسل)
▶ مثال
عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:
المخرجات:
Shows 'Hello, Vue developer'.
💡 نقاط مهمة
ℹ️ ملاحظة نفس الإضافة تُثبَّت مرة واحدة فقط: تُتجاهل محاولات use المتكررة (عدا النسخ المتعددة).
💡 نصيحة عند كتابة الإضافة علّق قدراتها على app.config.globalProperties أو عبر provide، وكلا الأسلوب شائع.
⚠️ تحذير يجب أن يكون use قبل mount؛ الإضافات المثبتة بعد التحميل لا تسري مفعولها.
🏷️ واجهة API العامة ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س ما علاقة الإضافات بمكتبات المكوّنات؟
ج معظم مكتبات الواجهة هي إضافات: app.use(Library) يسجّل جميع المكوّنات دفعة واحدة.
س هل يمكن تثبيت عدة إضافات؟
ج نعم، وقد يؤثر الترتيب على التهيئة (انتبه للتسلسل عندما يعتمد router على store مثلاً).
س هل يكرر التثبيت المتكرر التسجيل؟
ج لا، فالإضافة تسجّل حالة التثبيت داخلياً.