مرجع Vue

آخر تحديث: 2026-10-22

مرجع Vue

قائمة أبجدية بـ 121 عنصراً من واجهة Vue: التوجيهات و Composition API و Options API والمدمجات وواجهة API العامة.

#
$attrs	يجمع $attrs الخصائص التي مرّرها الأب ولم تصرّح بها props، مع inheritAttrs: false لتوزيعها ...
$emit()	يُطلق $emit حدثاً مخصصاً تُمرَّر وسائطه كما هي إلى دالة الاستماع في المكوّن الأب: إنها الق...
$refs	تحفظ $refs العناصر أو نُسخ المكوّنات الموسومة بسمة ref في القالب: تستفيد منها السكربتات لل...
<component>	يعرض <component :is="..."> أي مكوّن أو عنصر أصلي تشير إليه البيانات — وهو الأساس وراء التب...
<KeepAlive>	يخزّن <KeepAlive> نسخ المكوّنات المغلّفة مؤقتًا، فتبقى الحالة عند التبديل ويُتجنّب إعادة ا...
<slot>	يحدّد <slot> الموضع الذي يبلغه المحتوى المقدَّم من المكوّن الأب داخل قالب الابن، مع محتوى ...
<Suspense>	يعرض <Suspense> محتوى بديلًا (fallback) إلى أن تكتمل الاعتماديات غير المتزامنة (مكوّنات as...
<Teleport>	يعرض <Teleport> محتواه في مكان آخر من DOM (مثل body)، متجاوزًا مشكلات القص بسبب overflow و...
<template>	يعمل <template> كغلاف شفاف لتجميع العناصر — لا يعرض شيئًا بذاته، وهو مفيد لتجميعات v-if/v-...
<Transition>	يغلّف <Transition> عنصرًا أو مكوّنًا واحدًا، ويطبّق أصناف الانتقال أو الخطّافات (hooks) عن...
<TransitionGroup>	يحرّك <TransitionGroup> قوائم العناصر بحركة سلسة، بما في ذلك انتقالات المواضع عبر تقنية FL...
A
activated	يُستدعى activated عند إعادة عرض المكوّن المخزَّن بـ <KeepAlive>: لاستئناف الاستقصاء وتحديث...
app.component()	تُسجّل app.component() المكوّن بشكل عام: جميع قوالب المكوّنات يمكنها استخدامه مباشرة، وهو ...
app.config	يوفر app.config إعدادات على مستوى التطبيق: errorHandler و warnHandler و globalProperties و...
app.directive()	تُسجّل app.directive() توجيهاً مخصصاً عاماً: يُستخدم بالشكل v-xxx في قوالب أي مكوّن، وهو م...
app.mount()	تُحمّل app.mount() التطبيق على عنصر الحاوية: يُستبدل ما داخل الحاوية بـ DOM الذي يصيّره ال...
app.provide()	توفّر app.provide() التبعيات على مستوى التطبيق: جميع المكوّنات تستطيع عمل inject لها، وهو ...
app.use()	تُثبّت app.use() الإضافة: يمكن للإضافة تسجيل مكوّنات وتوجيهات عامة، أو حقن تبعيات، أو إضاف...
B
beforeCreate	يُستدعى beforeCreate قبل تهيئة النسخة: لم تُبنَ data و methods و computed بعد، ولهذا نادرا...
beforeMount	يُستدعى beforeMount قبل حدوث أول تصيير: دالة التصيير جاهزة، لكن DOM لم يُبنَ بعد.
beforeUnmount	يُستدعى beforeUnmount قبيل تدمير النسخة: لا يزال DOM صالحاً، وهو الوقت المناسب لتنظيف المؤ...
beforeUpdate	يُستدعى beforeUpdate بعد تغيّر البيانات وقبيل تحديث DOM: ما تقرؤه في هذه اللحظة لا يزال DO...
C
components	يسجّل خيار components المكوّنات الأبناء محلياً: فتبقى متاحة داخل هذا المكوّن فقط، متجنبةً ...
computed	يصرّح خيار computed بقيم مشتقة: يُعاد حسابها وتخزينها تلقائياً عند تغيّر التبعيات، وتُستخد...
computed()	تشتق computed() قيمة جديدة من بيانات تفاعلية أخرى وتخزّنها مؤقتًا: لا يُعاد الحساب إلا عند...
createApp()	تنشئ createApp() نسخة تطبيق من المكوّن الجذري، ويوفّر الكائن المُعاد قدرات على مستوى التطب...
created	يُستدعى created بعد اكتمال تهيئة النسخة وتوفر البيانات والدوال: لا يوجد DOM بعد، وهو مناسب...
createSSRApp()	تشبه createSSRApp() برنامج createApp، لكنها تتولى HTML المُصيَّر على الخادم بطريقة الترطيب...
customRef()	تتيح customRef() تخصيص تتبع الاعتماديات وتوقيت الإطلاق عبر دالة مصنع، والاستخدام النموذجي ...
D
data	يصرّح خيار data بحالة المكوّن التفاعلية: يجب كتابته كدالة تُعيد كائناً، لضمان امتلاك كل نس...
deactivated	يُستدعى deactivated عند إخفاء المكوّن المخزَّن بـ <KeepAlive>: المكوّن لم يُدمَّر، وهو منا...
defineAsyncComponent()	تنشئ defineAsyncComponent() مكوّناً يُحمَّل عند الطلب: تُحمَّل الشيفرات عند أول تصيير فقط،...
defineComponent()	defineComponent() دالة مساعدة لاستدلال الأنواع: توفّر أنواعاً دقيقة لخيارات المكوّن في مشا...
defineCustomElement()	تغلّف defineCustomElement() مكوّن Vue ليصبح Web Component قياسياً: يمكن استهلاكه بوسم <my-...
E
effectScope()	تُنشئ effectScope() نطاقًا يجمع عدة مستمعين/خصائص محسوبة معًا لبدئها وإيقافها موحّدةً، بدل...
emits	يصرّح خيار emits بالأحداث التي يُطلقها المكوّن نحو المكوّن الأب، فيؤدي دور التوثيق والتحقق...
errorCaptured	يلتقط errorCaptured أخطاء مكوّنات الأحفاد: وإعادة false تمنع استمرار فقاعه نحو المعالج الع...
expose	يقيد خيار expose الأعضاء التي يصل إليها المكوّن الأب عبر مرجع القالب: الكل مكشوف افتراضياً...
G
getCurrentScope()	تُعيد getCurrentScope() نطاق effectScope الحالي (أو undefined إن لم يوجد)، وتُستخدم في الد...
H
h()	تنشئ h() عقداً افتراضية (VNode): إنها الواجهة الأساسية تحت دوال التصيير و JSX، وتُستخدم أي...
hasInjectionContext()	تحدّد hasInjectionContext() ما إذا كان السياق الحالي يسمح باستخدام inject (داخل setup أو ا...
I
inheritAttrs	عند ضبط inheritAttrs إلى false لا تهبط الخصائص غير المصرّح بها على العنصر الجذر تلقائياً، ...
inject	يصرّح خيار inject بالتبعيات المطلوب حقنها: صيغة المصفوفة لا تضبط قيماً افتراضية، وصيغة الك...
inject()	تستخدم inject() في أي مكوّن ابن البيانات التي وفّرها الأجداد عبر provide، ويمكن توفير قيمة...
is	تحدِّد السمة is لـ <component> المكوّن أو الوسم الأصلي المطلوب عرضه، بما في ذلك التبديل بي...
isProxy()	تحدّد isProxy() ما إذا كانت القيمة وكيلًا أُنشئ بواسطة reactive() أو readonly().
isReactive()	تحدّد isReactive() ما إذا كانت القيمة أُنشئت بواسطة reactive() (أو وكيل مشتق منها).
isReadonly()	تحدّد isReadonly() ما إذا كانت القيمة أُنشئت بواسطة readonly() (بما في ذلك وكلاء القراءة ف...
isRef()	تحدّد isRef() ما إذا كانت القيمة كائن ref، وتُستخدم كثيرًا في الدوال المساعدة للتمييز بين ...
K
key	يُعرِّف key عناصر القائمة في v-for، ما يتيح لـ Vue إعادة استخدام العقد أو إعادة بنائها بشك...
M
markRaw()	بعد وسم markRaw() للكائن لن يُوكَّع حتى لو وُضع داخل بنية تفاعلية، وهو مناسب لنسخ المكتبات...
mergeProps()	تدمج mergeProps() عدة كائنات خصائص: يُدمج class و style بالسلسل، وتُحفظ جميع مستمعي الأحدا...
methods	يجمّع خيار methods دوال المكوّن في مكان واحد: معالجة الأحداث والدوال المساعدة كلها تُكتب ه...
mounted	يُستدعى mounted بعد تصيير المكوّن وإدراجه في DOM: الموقع القياسي للتعامل مع مراجع القوالب ...
N
name	يُسمّي خيار name المكوّن: فيؤثر في عرض أدوات المطور، والاستدعاء الذاتي للمكوّنات العودية، ...
nextTick()	تُعيد nextTick() وعداً (Promise) يتحقق بعد اكتمال تحديث DOM القادم: استخدمها عندما تعدّل ا...
O
onActivated()	تُستدعى onActivated() عندما يُعاد عرض المكوّن المخزَّن بـ <KeepAlive> (تنشيطه): مناسبة لاس...
onBeforeMount()	تُستدعى onBeforeMount() قبل عرض المكوّن أول مرة إلى DOM: حينها قُدّم جمع القالب لكن DOM ال...
onBeforeUnmount()	تُستدعى onBeforeUnmount() قبل تدمير المكوّن مباشرة: لا يزال DOM صالحًا، وهي الفرصة الأخيرة...
onBeforeUpdate()	تُستدعى onBeforeUpdate() بعد تغيّر البيانات التفاعلية وقبل تحديث DOM مباشرة: عندئذ يمكن قر...
onDeactivated()	تُستدعى onDeactivated() عندما يُخفى المكوّن المخزَّن بـ <KeepAlive> (إيقافه): المكوّن لم ي...
onErrorCaptured()	تُمسك onErrorCaptured() الأخطاء التي تطرحها المكوّنات الأبناء أثناء العرض/دورة الحياة/الاس...
onMounted()	تُستدعى onMounted() بعد تحميل المكوّن ومكوناته الأبناء إلى DOM: وهي الموقع القياسي للحصول ...
onRenderTracked()	تُستدعى onRenderTracked() عند جمع كل اعتمادية تفاعلية أثناء عرض المكوّن، ومع المنقّح يمكن ...
onRenderTriggered()	تُستدعى onRenderTriggered() عندما يؤدي تغيّر اعتمادية إلى إعادة عرض المكوّن، وتخبرك مباشرة...
onScopeDispose()	تُنفّذ onScopeDispose() التنظيف عند توقف النطاق الحالي: تُستخدم عند كتابة الدوال التركيبية...
onServerPrefetch()	تُنفَّذ onServerPrefetch() أثناء العرض على الخادم فقط: لا يُعرض HTML إلا بعد اكتمالها، وتُ...
onUnmounted()	تُستدعى onUnmounted() بعد تدمير المكوّن وإزالة DOM وتوقف جميع آثاره الجانبية التفاعلية.
onUpdated()	تُستدعى onUpdated() بعد أن يُعيد المكوّن العرض بسبب تغيّر تفاعلي ويُحدَّث DOM: مناسبة لقرا...
onWatcherCleanup()	تُسجّل onWatcherCleanup() دالة تنظيف تُستدعى قبل أن يفقد المستمع صلاحيته (عند إعادة تنفيذه...
P
props	تصريح props يحدد الخصائص التي يستقبلها المكوّن خارجياً، ويدعم الاختصار بالمصفوفة والصيغة ا...
provide	يوفّر خيار provide البيانات للأحفاد على هيئة كائن أو دالة: صيغة الكائن توفّر قيماً ثابتة، ...
provide()	توفّر provide() البيانات في المكوّن الأجداد، ويمكن لأي مكوّن ابن مهما تدرّجت مستوياته الحص...
R
reactive()	تغلّف reactive() الكائن أو المصفوفة في وكيل تفاعلي عميق — فقراءة الخصائص وكتابتها مباشرةً ...
readonly()	تُنشئ readonly() وكيلًا للقراءة فقط من البيانات الأصلية: أي كتابة تُصدر تحذيرًا وتفشل، لحم...
ref	تُسمّي السمة ref عنصرًا أو مكوّنًا للوصول إليه من الشيفرة عبر $refs أو ref()/useTemplateRe...
ref()	تغلّف ref() أي قيمة داخل كائن تفاعلي يُقرأ ويُكتب من خلال ‎.value؛ وتُستخدم للاحتفاظ بالأن...
render	يُعيد خيار render العقد الافتراضية من دالة بدلاً من القالب: يُستخدم عند الحاجة للتعبير عن ...
renderToString()	تصيّر renderToString() التطبيق إلى سلسلة HTML على خادم Node: وهي مرحلة الإخراج في SSR، وتق...
resolveComponent()	تُوجد resolveComponent() المكوّن باسمه المسجّل داخل دالة التصيير: بعد الحصول على تعريف الم...
S
shallowReactive()	تجعل shallowReactive() خصائص المستوى الأول فقط تفاعلية، وتُبقي الكائنات المتداخلة كما هي (...
shallowReadonly()	تجعل shallowReadonly() خصائص المستوى الأول فقط للقراءة فقط، وتظل الكائنات المتداخلة قابلة ...
shallowRef()	تتتبع shallowRef() استبدال .value فقط دون وكلاء عميقين للكائنات الداخلية: الاستبدال الكامل...
slots	يصرّح خيار slots بالوصول إلى الـ slots على هيئة دوال، ويولّد $slots في وقت الترجمة: فيصبح ...
T
template	يحدد خيار template سلسلة قالب HTML للمكوّن: تُترجم إلى دالة تصيير في وقت التشغيل (تدعمه ال...
toRaw()	تُعيد toRaw() الكائن الأصلي خلف الوكيل: تُستخدم عند الحاجة إلى تجاوز التتبع التفاعلي، أو ع...
toRef()	تحوّل toRef() خاصية من كائن تفاعلي إلى ref يبقى مرتبطًا بالاتجاهين: القراءة والكتابة من خل...
toRefs()	تحوّل toRefs() كل خاصية من الكائن التفاعلي إلى ref، فتبقى القيم المفكَّكة تفاعلية — وهي ال...
toValue()	توحّد toValue() الاستخراج من قيمة عادية أو ref أو دالة getter إلى القيمة الحالية: فتستطيع ...
triggerRef()	تُطلق triggerRef() يدويًا الآثار الجانبية المرتبطة بـ shallowRef: فهي الحل عندما تعديلات د...
U
unmounted	يُستدعى unmounted بعد تدمير النسخة وإزالة DOM منها: للموعد الأخير لتحرير الموارد وإعادة ضب...
unref()	unref() هي اختصار لـ isRef(v) ? v.value : v: تستخرج القيمة الداخلية من ref، وتُعيد القيم ا...
updated	يُستدعى updated بعد أن يُعيد تغيّر البيانات تصيير المكوّن ويكتمل تحديث DOM: مناسب لإعادة ا...
useAttrs()	تُعيد useAttrs() الخصائص المُمرَّرة غير المصرَّح بها في props/emits (مثل class وid ومستمعي...
useHost()	تحصل useHost() داخل العنصر المخصص على عنصر المضيف (مضيف الـ shadow DOM)، للتعامل مع خصائص ...
useId()	تُعيد useId() سلسلة معرّف فريدة ومستقرة لكل نسخة مكوّن: تُستخدم لخصائص الوصولية مثل label/...
useModel()	تُعرِّف useModel() داخل <script setup> نموذجًا قابلًا للكتابة: عندما يربط المكوّن الأب v-m...
useSlots()	تُعيد useSlots() مجموعة دوال الفتحات الممرَّرة من المكوّن الأب، وتُستخدم للحكم في السكربت ...
useSSRContext()	تحصل useSSRContext() على كائن السياق أثناء التصيير في الخادم: استخدمها لتعليق البيانات الت...
useTemplateRef()	تحصل useTemplateRef() على مرجع القالب الخاصية ref التي تحمل الاسم نفسه عبر مفتاح نصي، متجن...
V
v-bind (:)	يربط v-bind تعبيرًا بسمة HTML، وصيغته المختصرة النقطتان :. وتقبل class وstyle إضافةً صيغة ...
v-cloak	يبقى v-cloak على العنصر حتى تنتهي الترجمة؛ ومع CSS يخفي القالب الخام ويمنع وميض {{ }} عند ...
v-else	يوفر v-else الفرع البديل لـ v-if: يُعرض عندما يكون v-if خاطئًا، ولا يأخذ أي تعبير.
v-else-if	يربط v-else-if فروعًا شرطية متعددة، فيقيّمها واحدًا تلو الآخر حتى يصادف فرعًا صحيحًا.
v-for	يعرض v-for قائمة عناصر بالمرور على مصفوفة أو كائن بصيغة item in items. وفِّر دائمًا key لض...
v-html	يحلِّل v-html السلسلة بوصفها HTML ويحقنها في العنصر — ويُستخدم لمحتوى النص الغني.
v-if	يعرض v-if الكتلة فقط عندما يكون التعبير صحيحًا (truthy). وعندما يكون خاطئًا يُدمَّر العنصر...
v-memo	يأخذ v-memo مصفوفة اعتماديات؛ وإذا لم تتغيّر تُتخطى الشجرة الفرعية بأكملها — أداة أداء للق...
v-model	ينشئ v-model ربطًا ثنائي الاتجاه بين أداة النموذج والبيانات: الكتابة تُحدِّث الحالة، والحا...
v-on (@)	يربط v-on مستمع أحداث، وصيغته المختصرة @. وتُخصِّص المعدِّلات مثل .stop و.prevent و.once ا...
v-once	يعرض v-once العنصر مرة واحدة فقط؛ فالتغييرات اللاحقة على بياناته لا تعيد عرضه — وهو تحسين ...
v-pre	يتخطى v-pre ترجمة هذا العنصر وأبنائه، فيُعرض صياغة القالب مثل {{ }} كما هي — وهو مفيد عند ...
v-show	يبدِّل v-show نمط display للعنصر وفق التعبير. يبقى العنصر دائمًا في DOM — يتغيّر ظهوره فقط...
v-slot (#)	يعلن v-slot محتوى الـ slot، وصيغته المختصرة #. ويمرِّر أجزاء القالب إلى slots مُسمّاة أو ذ...
v-text	يضبط v-text الخاصية textContent للعنصر من قيمة التعبير. وهو يعادل الاستيفاء بالأقواس المزد...
W
watch	ينظّم خيار watch ردود الأحداث وفق «اسم البيانات المراقَبة»: ويدعم handler و deep و immedia...
watch()	تراقب watch() مصدرًا تفاعليًا واحدًا أو أكثر وتنفّذ دالة رد عند التغيّر مع توفير القيمتين ...
watchEffect()	تُنفّذ watchEffect() الدالة الممرّرة فورًا وتتتبع تلقائيًا كل البيانات التفاعلية المستخدمة...
watchPostEffect()	تكافئ watchPostEffect()‏ watchEffect مع flush: 'post': تُنفّذ بعد تحديث DOM للمكوّن، ومناس...
watchSyncEffect()	تكافئ watchSyncEffect()‏ watchEffect مع flush: 'sync': تُنفّذ تزامنيًا فور تغيّر الاعتمادي...
withModifiers()	تضيف withModifiers() سلوك المُعدّلات (stop و prevent و once وغيرها) إلى دوال معالجة الأحدا...

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

من نحن