v-once العرض مرة واحدة
آخر تحديث: 2026-10-22
v-once العرض مرة واحدة
يعرض v-once العنصر مرة واحدة فقط؛ فالتغييرات اللاحقة على بياناته لا تعيد عرضه — وهو تحسين صغير للمحتوى الثابت.
| المجموعة | التوجيهات |
|---|---|
| النوع | توجيه |
| النطاق | القالب |
| إصدار Vue | 3.0+ |
| دعم SSR | مدعوم |
📝 الصيغة
<p v-once>Initial: {{ msg }}</p>⚙️ الوسائط
| expression | بلا تعبير |
|---|
القيمة المُرجعة：توجيه، بلا قيمة مُعادة
▶ مثال
عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:
المخرجات：
After clicking, the live paragraph updates while the frozen one keeps the initial text.💡 نقاط مهمة
ℹ️ ملاحظة مثالي لأرقام الإصدارات وسطور حقوق النشر وسائر المحتوى الذي لا يتغيّر.
⚠️ تحذير لا تصل التغييرات اللاحقة للبيانات إلى عقدة v-once أبدًا — فإساءة استخدامه على محتوى ديناميكي تعطي نتائج قديمة.
💡 نصيحة يشمل v-once الشجرة الفرعية للعنصر بأكملها.
🏷️ التوجيهات ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س أي محتوى يناسب v-once؟
ج نص ثابت لا يتغيّر بعد التركيب (mount)، مثل سطر حقوق النشر أو رقم الإصدار.
س لماذا لا تُحدَّث الصفحة عند تغيّر البيانات؟
ج بحكم التصميم تخرج تلك الشجرة الفرعية من مسار العرض — فإساءة الاستخدام تُظهر بيانات قديمة.
س هل يمكن الجمع بينه وبين v-for؟
ج يمكن، لكن للقوائم الديناميكية فالأداة الأنسب هي v-memo.
