triggerRef() إطلاق تحديث ref الضحل يدويًا
آخر تحديث: 2026-10-22
triggerRef() إطلاق تحديث ref الضحل يدويًا
تُطلق triggerRef() يدويًا الآثار الجانبية المرتبطة بـ shallowRef: فهي الحل عندما تعديلات داخلية لا يستطيع Vue تتبّعها ويحتاج الأمر إلى إشعار إضافي.
| المجموعة | التفاعلية: المتقدم |
|---|---|
| النوع | API |
| النطاق | داخل المكوّن |
| إصدار Vue | 3.0+ |
| دعم SSR | مدعوم |
📝 الصيغة
big.value.list.push(1) // لا يُطلق التحديث
triggerRef(big) // إطلاقه يدويًا⚙️ الوسائط
| shallowRef | المرجع الضحل الذي يلزم إطلاق تحديثه |
|---|
القيمة المُرجعة：لا شيء
▶ مثال
عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:
المخرجات：
Each click increments the length (without triggerRef it would stay at 1).💡 نقاط مهمة
⚠️ تحذير تُحتاج فقط مع المراجع الضحلة / الاستجابة الضحلة: فالمراجع العادية العميقة تتتبع تلقائيًا ولا تحتاج تعويضًا يدويًا.
ℹ️ ملاحظة بعد تغيّر مصادر بيانات خارجية قابلة للتغيير (مثل الحالة الداخلية لمكتبة خارجية) يمكن مزامنتها إلى الواجهة من خلالها.
🏷️ المتقدم ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س هل يمكنها أن تحل محل الاستبدال الكامل؟
ج يمكن ذلك، لكن دلالة الاستبدال الكامل أوضح وأكثر انسجامًا مع النموذج الذهني للتفاعلية؛ وtriggerRef وسيلة ترقيعية.
س ما تأثيرها عند استخدامها مع ref عادي؟
ج وظيفيًا ستُطلق تحديثًا أيضًا، لكن ذلك عادةً غير ضروري.
س هل تسبّب عمليات عرض إضافية؟
ج نعم: تُطلق كل مرة الآثار الجانبية المرتبطة، فكن حذرًا عند الاستدعاء المتكرر.
