English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
يتم إرسال أحداث DOM لتعليم البرمجة عن الأحداث المثيرة التي تحدث.
يستخدم الحدث عادةً مع الوظائف، ولا يتم تنفيذ الوظيفة قبل حدوث الحدث (مثل الضغط على الزر).
يمكن استخدام الحدث للتعبير عن أي شيء، من التفاعلات الأساسية للمستخدم إلى إشعارات تلقائية تحدث في نموذج العرض.
| اسم النشاط | وصف | نوع الحدث |
|---|---|---|
| abort | يحدث هذا الحدث عند إيقاف تحميل الموارد | UiEvent, Event |
| afterprint | يحدث هذا الحدث عند بدء الطباعة أو إغلاق عرض الطباعة | Event |
| animationend | يحدث هذا الحدث عند اكتمال حركة الرسوميات بالCSS | يعود عدد الثواني التي مرت على تشغيل التحريك |
| animationiteration | يحدث هذا الحدث عند تكرار حركة الرسوميات بالCSS | يعود عدد الثواني التي مرت على تشغيل التحريك |
| animationstart | يحدث هذا الحدث عند بدء حركة الرسوميات بالCSS | يعود عدد الثواني التي مرت على تشغيل التحريك |
| beforeprint | عندما يتم طباعة أو عرض مستندات المراجعة للطباعة، يحدث هذا الحدث | Event |
| beforeunload | يحدث هذا الحدث عندما يكون النافذة والمستند ومواردها على وشك التشغيل | UiEvent, Event |
| blur | يحدث هذا الحدث عندما يفقد العنصر التركيز (لن ينتشر) | FocusEvent |
| canplay | يحدث هذا الحدث عندما يمكن للتصفح البدء في تشغيل الإعلام (عندما يكون لديه كافٍ من التحميل لتشغيل البداية) | Event |
| canplaythrough | يحدث هذا الحدث عندما يمكن للتصفح أن يبدأ تشغيل الإعلام دون توقف التحميل | Event |
| change | يحدث هذا الحدث عندما يتم تغيير محتوى حالة الاختيار أو الافتراضية للعنصر النموذجي أو الاختيار أو النص (بالنسبة لـ<input>،<select>و<textarea>) | Event |
| click | يحدث هذا الحدث عندما يضغط المستخدم على العنصر | MouseEvent |
| contextmenu | يحدث هذا الحدث عندما يضغط المستخدم على زر الماوس اليمين لفتح قائمة السياق | MouseEvent |
| copy | يحدث هذا الحدث عندما ينسخ المستخدم محتوى العنصر | ClipboardEvent |
| cut | يحدث هذا الحدث عندما يقطع المستخدم محتوى العنصر | ClipboardEvent |
| dblclick | يحدث هذا الحدث عندما يضرب المستخدم العنصر مرتين بالسرعة | MouseEvent |
| drag | يحدث هذا الحدث عند تحريك العنصر المتحرك | DragEvent |
| dragend | يحدث هذا الحدث عندما يكمل المستخدم تحريك العنصر | DragEvent |
| dragenter | يحدث هذا الحدث عندما يدخل العنصر المتحرك في هدف التحريك | DragEvent |
| dragleave | يحدث هذا الحدث عندما يبتعد العنصر المتحرك عن هدف التحريك | DragEvent |
| dragover | يحدث هذا الحدث عندما يمر العنصر المتحرك فوق هدف التحريك | DragEvent |
| dragstart | يحدث هذا الحدث عندما يبدأ المستخدم في تحريك العنصر | DragEvent |
| drop | يحدث هذا الحدث عندما يتم وضع العنصر المتحرك على هدف التحريك | DragEvent |
| durationchange | يحدث هذا الحدث عند تغيير دقة العرض الإعلامي | Event |
| ended | يحدث هذا الحدث عندما يصل العرض الإعلامي إلى نهايته (مفيد جدًا للرسائل مثل 'شكرًا على الاستماع') | Event |
| error | يحدث هذا الحدث عند فشل تحميل الموارد | ProgressEvent, UiEvent, Event |
| focus | يحدث هذا الحدث عندما يحصل العنصر على التركيز (لن ينتشر) | FocusEvent |
| focusin | يحدث هذا الحدث عند اقتراب عنصر من الحصول على التركيز | FocusEvent |
| focusout | يحدث هذا الحدث عند اقتراب عنصر من فقدان التركيز | FocusEvent |
| fullscreenchange | يحدث هذا الحدث عند عرض العنصر في نمط الشاشة الكاملة | Event |
| fullscreenerror | يحدث هذا الحدث عندما لا يمكن عرض العنصر في نمط الشاشة الكاملة | Event |
| hashchange | يحدث هذا الحدث عندما يتم تغيير جزء العنوان المربوط لـ URL | HashChangeEvent |
| input | يحدث هذا الحدث عندما يحصل العنصر على إدخال المستخدم | InputEvent, Event |
| invalid | يحدث هذا الحدث عندما يكون العنصر غير صالح | Event |
| keydown | يحدث هذا الحدث عندما يضغط المستخدم على مفتاح | KeyboardEvent |
| keypress | عندما يضغط المستخدم على المفتاح يحدث الحدث | KeyboardEvent |
| keyup | يحدث هذا الحدث عند إطلاق الزر. | KeyboardEvent |
| load | يحدث هذا الحدث عند تحميل العنصر. | UiEvent, Event |
| loadeddata | يحدث هذا الحدث عند تحميل بيانات الوسائط. | Event |
| loadedmetadata | يحدث هذا الحدث عند تحميل البيانات الوصفية (مثل الأبعاد والمدة). | Event |
| loadstart | يحدث هذا الحدث عند بدء البحث عن الوسائط المحددة. | ProgressEvent |
| message | يحدث هذا الحدث عند استقبال رسالة من مصدر الحدث. | Event |
| mousedown | يحدث هذا الحدث عندما يضغط المستخدم على زر الفأرة على العنصر. | MouseEvent |
| mouseenter | يحدث هذا الحدث عندما يتحرك مؤشر الفأرة إلى العنصر. | MouseEvent |
| mouseleave | يحدث هذا الحدث عندما يتحرك مؤشر الفأرة خارج العنصر. | MouseEvent |
| mousemove | يحدث هذا الحدث عندما يتحرك مؤشر الفأرة فوق العنصر. | MouseEvent |
| mouseover | يحدث هذا الحدث عندما يتحرك مؤشر الفأرة إلى العنصر أو أحد أبنائه. | MouseEvent |
| mouseout | يحدث هذا الحدث عندما يتحرك مؤشر الفأرة خارج العنصر أو أحد أبنائه. | MouseEvent |
| mouseup | يحدث هذا الحدث عند إطلاق زر الفأرة على العنصر. | MouseEvent |
| mousewheel | غير موصى به.استخدام حدث wheel. | يعود عدد يوضح وحدة القيمة الزيادة (البكسل، الخط أو الصفحة) |
| offline | يحدث هذا الحدث عندما يبدأ المتصفح في العمل دون اتصال بالإنترنت. | Event |
| online | يحدث هذا الحدث عندما يبدأ المتصفح في العمل عبر الإنترنت. | Event |
| open | يحدث هذا الحدث عند فتح الاتصال بمنبع الحدث. | Event |
| pagehide | يحدث هذا الحدث عندما يغادر المستخدم تحويل الصفحة. | PageTransitionEvent |
| عرض الصفحة | يحدث هذا الحدث عندما يتحرك المستخدم إلى صفحة الويب. | PageTransitionEvent |
| paste | يحدث هذا الحدث عندما يلصق المستخدم بعض المحتويات في العنصر. | ClipboardEvent |
| pause | يحدث هذا الحدث عندما يوقف المستخدم أو عن طريق البرمجة العرض. | Event |
| play | يحدث هذا الحدث عندما يبدأ العرض أو عندما يتوقف العرض. | Event |
| playing | يحدث هذا الحدث عند العودة إلى عرض الوسائط بعد إيقاف التحميل أو التوقف. | Event |
| popstate | يحدث هذا الحدث عند تغيير تاريخ الصفحة في النافذة. | PopStateEvent |
| progress | يحدث هذا الحدث عندما يكون المتصفح في عملية الحصول على بيانات الوسائط (تحميل الوسائط). | Event |
| ratechange | يحدث هذا الحدث عند تغيير سرعة عرض الوسائط. | Event |
| resize | يحدث هذا الحدث عند تعديل حجم عرض المستند. | UiEvent, Event |
| reset | يحدث هذا الحدث عند إعادة تعيين النموذج. | Event |
| scroll | يحدث الحدث عند سحب شريط التمرير لقطعة التمرير. | UiEvent, Event |
| search | يحدث هذا الحدث عندما يكتب المستخدم محتوى في حقل البحث (بالنسبة ل<input="search">). | Event |
| seeked | يحدث هذا الحدث عندما يكمل المستخدم التحرك / القفز إلى موقع جديد في الوسائط. | Event |
| seeking | يحدث هذا الحدث عندما يبدأ المستخدم في التحرك / القفز إلى موقع جديد في الوسائط. | Event |
| select | عندما يختار المستخدم نصًا معينًا (بالنسبة ل<input> و <textarea>)، يحدث هذا الحدث. | UiEvent, Event |
| show | يحدث هذا الحدث عند عرض عنصر <menu> كقائمة سياق | Event |
| stalled | يحدث هذا الحدث عند محاولة المتصفح للحصول على بيانات الوسائط ولكن البيانات غير متاحة | Event |
| storage | يحدث هذا الحدث عند تحديث منطقة التخزين على الويب | StorageEvent |
| submit | يحدث هذا الحدث عند تقديم نموذج | Event |
| suspend | يحدث هذا الحدث عند عدم استقبال المتصفح للمعلومات الوسائطية | Event |
| timeupdate | يحدث هذا الحدث عند تغيير موقف التشغيل (مثل، عند التقدم السريع إلى نقطة أخرى في الوسائط) | Event |
| toggle | يحدث هذا الحدث عند فتح أو إغلاق عنصر <details> | Event |
| touchcancel | يحدث هذا الحدث عند تعطيل اللمس | TouchEvent |
| touchend | يحدث هذا الحدث عند سحب الإصبع من الشاشة | TouchEvent |
| touchmove | يحدث هذا الحدث عند سحب الإصبع على الشاشة | TouchEvent |
| touchstart | يحدث هذا الحدث عند وضع الإصبع على الشاشة | TouchEvent |
| transitionend | يحدث هذا الحدث عند اكتمال التحويل CSS | TransitionEvent |
| unload | يحدث هذا الحدث عند تفريغ المستند أو الموارد التابعة | UiEvent, Event |
| volumechange | يحدث هذا الحدث عند تغيير حجم الوسائط (بما في ذلك إعداد الصوت على الصمت) | Event |
| waiting | يحدث هذا الحدث عند إيقاف تشغيل الوسائط لكن التشغيل المتوقع | Event |
| wheel | يحدث هذا الحدث عند تمرير عجلة الفأرة لأعلى أو لأسفل على العنصر | يعود عدد يوضح وحدة القيمة الزيادة (البكسل، الخط أو الصفحة) |
الجدول أدناه يبين خصائص أحداث DOM:
| خصائص | وصف | نوع الحدث |
|---|---|---|
| altKey | يعود بالحالة إذا تم الضغط على مفتاح "ALT" عند التفاعل مع الحدث | MouseEvent |
| altKey | يعود بالحالة إذا تم الضغط على مفتاح "ALT" عند التفاعل مع الحدث | KeyboardEvent, TouchEvent |
| animationName | يعود بالاسم الذي يحدد الحركة | يعود عدد الثواني التي مرت على تشغيل التحريك |
| bubbles | يعود بالحالة إذا كانت الحدث تتكون | Event |
| button | يعود بآلية الزر التي تم ضغطها عند حدوث الحدث الفأرة | MouseEvent |
| buttons | يعود بآلية الزر التي تم ضغطها عند حدوث الحدث الفأرة | MouseEvent |
| cancelable | يعود بالحالة إذا كان بإمكان الحدث منع عملياته الافتراضية | Event |
| charCode | يعود بتعريف الرمز للغة الأحرف التي تسبب الحدث | KeyboardEvent |
| changeTouches | يعود بقائمة تحتوي على جميع العناصر التي تغيرت الحالة بين اللمس السابق واللمس الحالي | TouchEvent |
| clientX | يعود بالعامل الذي يقيس العرض الفعلي للشاشة | MouseEvent, TouchEvent |
| clientY | يعود بالعامل الذي يقيس العرض الفعلي للشاشة | MouseEvent, TouchEvent |
| clipboardData | يعود بجدول يحتوي على البيانات التي تؤثر على عملية اللصق | ClipboardData |
| code | يعود بتعريف الرمز للماوس الذي يسبب الحدث | KeyboardEvent |
| composed | يعود بالحالة إذا كانت الحدث تتكون | Event |
| ctrlKey | يعود بالحالة إذا تم الضغط على مفتاح "CTRL" عند التفاعل مع أحداث الفأرة | MouseEvent |
| ctrlKey | ctrlKey | KeyboardEvent, TouchEvent |
| يعود ما إذا كان تم ضغط مفتاح 'CTRL' عند تحفيز حدث المفاتيح | currentTarget | Event |
| يعود إلى العنصر الذي أطلق الحدث من خلال مستمع الحدث | data | InputEvent |
| يعود إلى الحرف المدرج | dataTransfer | يعود إلى عنصر يحتوي على بيانات لسحب/إدراج أو حذف |
| DragEvent, InputEvent | defaultPrevented | Event |
| يعود ما إذا كان تم استدعاء طريقة preventDefault() للحدث | deltaX | يعود عدد يوضح وحدة القيمة الزيادة (البكسل، الخط أو الصفحة) |
| يعود حجم التدوير الأفقي للعجلة الفأرة (عنصر x) | deltaY | يعود عدد يوضح وحدة القيمة الزيادة (البكسل، الخط أو الصفحة) |
| يعود حجم التدوير العمودي للعجلة الفأرة (عنصر y) | deltaZ | يعود عدد يوضح وحدة القيمة الزيادة (البكسل، الخط أو الصفحة) |
| يعود حجم التدوير في المحور Z للعجلة الفأرة | deltaMode | يعود عدد يوضح وحدة القيمة الزيادة (البكسل، الخط أو الصفحة) |
| WheelEvent | detail | UiEvent |
| AnimationEvent | يعود عدد يوضح كم مرة تم ضرب الفأرة | يعود عدد الثواني التي مرت على تشغيل التحريك |
| AnimationEvent | elapsedTime | |
| يعود عدد الثواني التي مرت على الانتقال | eventPhase | Event |
| يعود المرحلة التي يتم فيها تقييم تدفق الحدث | inputType | InputEvent |
| يعود نوع التغيير المعدل (أي 'إدراج' أو 'حذف') | isComposing | يعود ما إذا كان حالة الحدث قيد التكوين |
| InputEvent, KeyboardEvent | isTrusted | Event |
| key | يعود قيمة المفتاح التي تمثلها الحدث | KeyboardEvent |
| key | يعود مفتاح المستودع المعدل | StorageEvent |
| keyCode | يعود بخصائص رمز Unicode للزر الذي يسبب الحدث onkeypress، أو رمز زر Unicode للزر الذي يسبب الحدث onkeydown أو onkeyup. | KeyboardEvent |
| location | يعود موقع المفتاح على لوحة المفاتيح أو الجهاز | KeyboardEvent |
| lengthComputable | يعود ما إذا كان طول التقدم يمكن حسابه | ProgressEvent |
| loaded | يعود كمية العمل المحمول | ProgressEvent |
| metaKey | يعود ما إذا كان تم ضغط مفتاح 'META' عند تحفيز الحدث | MouseEvent |
| metaKey | يعود ما إذا كان تم ضغط مفتاح 'الرمز' عند تحفيز حدث المفاتيح | KeyboardEvent, TouchEvent |
| MovementX | يعود العرض الأفقي للفأرة بالنسبة للحدث السابق moveMouse | MouseEvent |
| MovementY | يعود العرض العمودي للفأرة بالنسبة للحدث السابق moveMouse | MouseEvent |
| newValue | يعود القيمة الجديدة للمستودع المعدل | StorageEvent |
| newURL | يعود URL المستند بعد تغيير الهاش | HasChangeEvent |
| offsetX | يعود العرض الأفقي للفأرة بالنسبة للعنصر المستهدف | MouseEvent |
| offsetY | يعود العرض العمودي للفأرة بالنسبة للعنصر المستهدف | MouseEvent |
| oldValue | يعود القيمة القديمة للمستودع المعدل | StorageEvent |
| oldURL | يعود URL المستند قبل تغيير الهاش | HasChangeEvent |
| onemptied | يحدث هذا الحدث عند وقوع مشكلة سيئة وتصبح ملفات الوسائط غير متاحة بشكل فجائي (مثل قطع الاتصال بشكل غير متوقع) | |
| pageX | يعود بكسر الطول الخاص بالمؤشر الخاص بالوثيقة عند حدوث الحدث الفأرة | MouseEvent |
| pageY | يعود بكسر العرض الخاص بالمؤشر الخاص بالوثيقة عند حدوث الحدث الفأرة | MouseEvent |
| persisted | يعود بالحالة التي يتم فيها حفظ صفحة الويب من قبل متصفح الويب | PageTransitionEvent |
| propertyName | يعود باسم الخاصية CSS المتعلقة بالتحويل أو التحول | AnimationEvent, TransitionEvent |
| pseudoElement | يعود باسم الصيغة الزائفة للتحويل أو التحول | AnimationEvent, TransitionEvent |
| region | MouseEvent | |
| relatedTarget | يعود بالعنصر المتعلق بالعنصر الذي يسبب الحدث الفأرة | MouseEvent |
| relatedTarget | يعود بالعنصر المتعلق بالعنصر الذي يسبب الحدث | FocusEvent |
| repeat | يعود بالحالة التي تم ضغط فيها مفتاح معين بمراراً وتكراراً | KeyboardEvent |
| screenX | يعود بكسر الطول الخاص بالمؤشر الخاص بالشاشة عند حدوث الحدث | MouseEvent |
| screenY | يعود بكسر العرض الخاص بالمؤشر الخاص بالشاشة عند حدوث الحدث | MouseEvent |
| shiftKey | يعود بالحالة التي تم ضغط فيها مفتاح SHIFT عند حدوث الحدث | MouseEvent |
| shiftKey | يعود بالحالة التي تم ضغط فيها مفتاح SHIFT عند حدوث الحدث ضغط المفتاح | KeyboardEvent, TouchEvent |
| state | يعود ببرنامج يحتوي على نسخة من سجل الإضافات | PopStateEvent |
| storageArea | يعود ببرنامج يعكس عنصر التخزين المتأثر | StorageEvent |
| target | يعود بالعنصر الذي يسبب الحدث | Event |
| targetTouches | يعود بلائحة جميع العناصر اللمسية التي تلامس السطح وتحدث الحدث touchstart على العنصر المستهدف الحالي | TouchEvent |
| timeStamp | يعود بوقت إنشاء الحدث (بملايين الأشهر التي مرت على الإرادة) | Event |
| total | يعود بكمية العمل الذي سيتم تحميله | ProgressEvent |
| touches | يعود بلائحة جميع العناصر اللمسية التي تلامس السطح الحالي | TouchEvent |
| transitionend | يحدث هذا الحدث عند اكتمال التحويل CSS | TransitionEvent |
| type | يعود باسم الحدث | Event |
| url | يعود بURL مستند المشروع الذي تم تغييره | StorageEvent |
| which | يعود بآلية الزر التي تم ضغطها عند حدوث الحدث الفأرة | MouseEvent |
| which | يعود بخصائص رمز Unicode للزر الذي يسبب الحدث onkeypress، أو رمز زر Unicode للزر الذي يسبب الحدث onkeydown أو onkeyup. | KeyboardEvent |
| view | يعيد مرجع إلى نافذة الحدث | UiEvent |
في الجدول أدناه، تم قائمة بالطرق الخاصة بأحداث DOM:
| الطريقة | وصف | نوع الحدث |
|---|---|---|
| createEvent() | إنشاء حدث جديد | Event |
| getTargetRanges() | يعيد مجموعة تحتوي على نطاق الهدف، والذي سيتم تأثيره عند إدراج/حذف | InputEvent |
| getModifierState() | يعيد مجموعة تحتوي على نطاق الهدف، والذي سيتم تأثيره عند إدراج/حذف | MouseEvent |
| preventDefault() | منع المتصفح من تنفيذ عملية افتراضية مختارة للأحداث | Event |
| stopImmediatePropagation() | منع استدعاء المستمعين الآخرين للحدث نفسه | Event |
| stopPropagation() | منع انتقال الأحداث في تدفق الأحداث | Event |
دليل تعليمات جافا سكربت:أحداث جافا سكربت
دليل تعليمات جافا سكربت:مراقب الأحداث
دليل تعليمات جافا سكربت:انتشار الأحداث