HTML DOM الأحداث
تسمح أحداث HTML DOM جافا سكريبت لتسجيل معالجات الأحداث المختلفة على عناصر في وثيقة HTML.
وتستخدم عادة الأحداث في تركيبة مع وظائف، ولن يتم تنفيذ وظيفة قبل وقوع الحدث (such as when a user clicks a button) .
Tip: كانت موحدة نموذج الحدث من قبل W3C DOM في المستوى 2.
HTML DOM الأحداث
DOM: يشير التي تم تقديمها DOM المستوى الممتلكات.
أحداث الماوس
هدف | وصف | DOM |
---|
عند النقر | يحدث هذا الحدث عندما يقوم المستخدم بالنقر على عنصر | 2 |
oncontextmenu | يحدث هذا الحدث عندما بزر الماوس الأيمن ينقر المستخدم على عنصر لفتح قائمة السياق | 3 |
ondblclick | يحدث هذا الحدث عندما يقوم المستخدم بالنقر نقرا مزدوجا فوق على عنصر | 2 |
عند_ضغط_الماوس | يحدث هذا الحدث عندما يقوم المستخدم بالضغط على زر الماوس فوق عنصر | 2 |
onmouseenter | يحدث هذا الحدث عندما يتم نقل المؤشر على عنصر | 2 |
onmouseleave | يحدث هذا الحدث عندما يتم نقل المؤشر من عنصر | 2 |
onmousemove | يحدث هذا الحدث عندما يكون المؤشر يتحرك في حين كان أكثر من عنصر | 2 |
على الفأرة فوق | يحدث هذا الحدث عندما يتم نقل المؤشر على عنصر، أو على واحد من أبنائها | 2 |
onmouseout | يحدث هذا الحدث عندما يقوم المستخدم بتحريك مؤشر الماوس من عنصر، أو من أصل واحد من أبنائها | 2 |
onmouseup | يحدث هذا الحدث عندما يطلق المستخدم على زر الماوس فوق عنصر | 2 |
لوحة المفاتيح الأحداث
هدف | وصف | DOM |
---|
عند_ضغط_مفتاح | يحدث هذا الحدث عندما يقوم المستخدم بالضغط على مفتاح | 2 |
onkeypress | يحدث هذا الحدث عندما يقوم المستخدم بالضغط على مفتاح | 2 |
onkeyup | يحدث هذا الحدث عندما يطلق المستخدم مفتاح | 2 |
الإطار / كائن الأحداث
هدف | وصف | DOM |
---|
onabort | يحدث هذا الحدث عندما تم إحباط تحميل مورد | 2 |
onbeforeunload | يحدث هذا الحدث قبل وثيقة على وشك أن تفرغ | 2 |
onerror | يحدث هذا الحدث عند حدوث خطأ أثناء تحميل ملف خارجي | 2 |
onhashchange | يحدث هذا الحدث عندما يكون هناك تغييرات على جزء مرساة لURL | 3 |
ONLOAD | يحدث هذا الحدث عندما تم تحميل كائن | 2 |
onpageshow | يحدث هذا الحدث عندما يتنقل المستخدم إلى صفحة ويب | 3 |
onpagehide | يحدث هذا الحدث عندما يتنقل المستخدم بعيدا عن صفحة ويب | 3 |
onresize | يحدث هذا الحدث عندما يتم تغيير حجم عرض المستند | 2 |
onscroll | يحدث هذا الحدث عندما يتم تمريره شريط التمرير عنصر في | 2 |
معالج onunload | يحدث هذا الحدث مرة واحدة في الصفحة تمت تفريغ (ل<body>) | 2 |
أحداث النموذج
هدف | وصف | DOM |
---|
على طمس | يحدث هذا الحدث عندما يفقد عنصر التركيز | 2 |
على التغيير | يحدث هذا الحدث عندما يكون محتوى عنصر نموذج، واختيار، أو الدولة فحص تغيرت (for <input>, <keygen>, <select>, and <textarea>) | 2 |
مركز | يحدث هذا الحدث عندما يحصل عنصر التركيز | 2 |
onfocusin | يحدث هذا الحدث عندما عنصرا على وشك الحصول على التركيز | 2 |
onfocusout | يحدث هذا الحدث عندما عنصرا على وشك أن يفقد التركيز | 2 |
oninput | يحدث هذا الحدث عندما يحصل عنصر إدخال المستخدم | 3 |
oninvalid | يحدث هذا الحدث عندما عنصر غير صالح | 3 |
onreset | يحدث هذا الحدث عندما تتم إعادة تعيين شكل | 2 |
onsearch | يحدث هذا الحدث عندما يكتب المستخدم شيء في حقل البحث (ل <المدخلات = "بحث">) | 3 |
onselect | يحدث هذا الحدث بعد أن يقوم المستخدم باختيار بعض النصوص (for <input> and <textarea>) | 2 |
onsubmit | يحدث هذا الحدث عندما يتم إرسال نموذج | 2 |
السحب الأحداث
هدف | وصف | DOM |
---|
ondrag | يحدث هذا الحدث عندما يتم سحب عنصر | 3 |
ondragend | يحدث هذا الحدث عندما ينتهي المستخدم من سحب عنصر | 3 |
ondragenter | يحدث هذا الحدث عندما يدخل عنصر جر انخفاض الهدف | 3 |
ondragleave | يحدث هذا الحدث عندما يترك عنصر جر انخفاض الهدف | 3 |
ondragover | يحدث هذا الحدث عندما العنصر جر هو على هدف إفلات | 3 |
ondragstart | يحدث هذا الحدث عندما يبدأ المستخدم لسحب عنصر | 3 |
ondrop | يحدث هذا الحدث عندما يتم إسقاط عنصر جره على هدف إفلات | 3 |
الحافظة الأحداث
هدف | وصف | DOM |
---|
oncopy | يحدث هذا الحدث عند نسخ المستخدم محتوى عنصر | |
oncut | يحدث هذا الحدث عندما يقطع المستخدم محتوى عنصر | |
onpaste | يحدث هذا الحدث عند لصق المستخدم بعض محتوى في عنصر | |
أحداث الطباعة
هدف | وصف | DOM |
---|
onafterprint | يحدث هذا الحدث عندما صفحة بدأت الطباعة، أو إذا تم إغلاق مربع الحوار طباعة | 3 |
onbeforeprint | يحدث هذا الحدث عندما صفحة على وشك أن تكون مطبوعة | 3 |
أحداث وسائل الإعلام
هدف | وصف | DOM |
---|
onabort | يحدث هذا الحدث عندما تم إحباط تحميل وسائل الاعلام | 3 |
oncanplay | يحدث هذا الحدث عند المستعرض يمكن بدء اللعب وسائل الإعلام (عندما مخزنة بما فيه الكفاية لبدء) | 3 |
oncanplaythrough | يحدث هذا الحدث عند المستعرض يمكن أن تقوم به من خلال وسائل الإعلام دون توقف للتخزين المؤقت | 3 |
ondurationchange | يحدث هذا الحدث عندما يتم تغيير مدة وسائل الإعلام | 3 |
onemptied | يحدث هذا الحدث عندما يحدث شيء سيئ وملف وسائط غير متوفر فجأة (like unexpectedly disconnects) | 3 |
onended | يحدث هذا الحدث عندما وسائل الإعلام له الوصول إلى نهاية (useful for messages like "thanks for listening") | 3 |
onerror | يحدث هذا الحدث عندما حدث خطأ أثناء تحميل ملف وسائط | 3 |
onloadeddata | يحدث هذا الحدث عندما تكون البيانات سائل الإعلام تحميل | 3 |
onloadedmetadata | يحدث هذا الحدث عندما تكون البيانات الفوقية (like dimensions and duration) هي تحميل | 3 |
onloadstart | يحدث هذا الحدث عندما يبدأ المتصفح تبحث عن وسائل الإعلام المحدد | 3 |
onpause | يحدث هذا الحدث عند توقف وسائل الإعلام سواء من قبل المستخدم أو برمجيا | 3 |
onplay | يحدث هذا الحدث عندما تم بدء تشغيل وسائل الإعلام أو لم يعد مؤقتا | 3 |
onplaying | يحدث هذا الحدث عندما يلعب وسائل الإعلام بعد أن تم إيقاف أو توقف عن التخزين المؤقت | 3 |
onprogress | يحدث هذا الحدث عندما المتصفح هو في عملية الحصول على البيانات وسائل الإعلام (downloading the media) | 3 |
onratechange | يحدث هذا الحدث عندما يتم تغيير سرعة اللعب وسائل الإعلام | 3 |
onseeked | يحدث هذا الحدث عند انتهاء المستخدم من نقل / تخطي إلى موضع جديد في وسائل الإعلام | 3 |
onseeking | يحدث هذا الحدث عندما يبدأ المستخدم نقل / تخطي إلى موضع جديد في وسائل الإعلام | 3 |
onstalled | يحدث هذا الحدث عند المستعرض هو محاولة للحصول على بيانات وسائل الاعلام، ولكن البيانات غير متوفرة | 3 |
onsuspend | يحدث هذا الحدث عندما يكون المتصفح عمدا عدم الحصول على البيانات وسائل الاعلام | 3 |
ontimeupdate | يحدث هذا الحدث عندما تغير موقف اللعب (مثل عندما الأمام بسرعة المستخدم إلى نقطة مختلفة في وسائل الإعلام) | 3 |
onvolumechange | يحدث هذا الحدث عند تغيير حجم وسائل الإعلام (بما في ذلك وضع وحدة التخزين إلى "كتم") | 3 |
onwaiting | يحدث هذا الحدث عندما توقف وسائل الإعلام ولكن من المتوقع أن تستأنف (مثل عند إيقاف وسائل الإعلام للتخفيف المزيد من البيانات) | 3 |
الرسوم المتحركة الأحداث
الانتقال الأحداث
هدف | وصف | DOM |
---|
transitionend | يحدث هذا الحدث عند اكتمال عملية الانتقال CSS | 3 |
الفعاليات المرسلة الخادم
هدف | وصف | DOM |
---|
onerror | يحدث هذا الحدث عند حدوث خطأ في مصدر الحدث | |
onmessage | يحدث هذا الحدث عند تلقي رسالة من خلال مصدر الحدث | |
عند_الفتح | يحدث هذا الحدث عند فتح اتصال مع مصدر الحدث | |
أحداث متفرقات
هدف | وصف | DOM |
---|
onmessage | يحدث هذا الحدث عند تلقي رسالة من خلال أو من كائن (WebSocket, Web Worker, Event Source or a child frame or a parent window) | 3 |
onmousewheel | إهمال. استخدام onwheel الحدث بدلا من ذلك | |
ononline | يحدث هذا الحدث عندما يبدأ المتصفح للعمل على الانترنت | 3 |
onoffline | يحدث هذا الحدث عندما يبدأ المتصفح للعمل دون اتصال | 3 |
onpopstate | يحدث هذا الحدث عندما يتغير تاريخ النافذة | 3 |
onshow | يحدث هذا الحدث عندما <menu> يظهر عنصر كقائمة السياق | 3 |
onstorage | يحدث هذا الحدث عندما يتم تحديث منطقة تخزين ويب | 3 |
ontoggle | يحدث هذا الحدث عندما يفتح المستخدم أو يغلق <details> العنصر | 3 |
onwheel | يحدث هذا الحدث عندما تتحرك عجلة الماوس لأعلى أو لأسفل على عنصر | 3 |
أحداث اتصال
هدف | وصف | DOM |
---|
ontouchcancel | يحدث هذا الحدث عندما تمت مقاطعة اتصال | |
ontouchend | يحدث هذا الحدث عندما تتم إزالة الإصبع من الشاشات التي تعمل باللمس | |
ontouchmove | يحدث هذا الحدث عندما يتم سحب الإصبع عبر الشاشة | |
ontouchstart | يحدث هذا الحدث عندما يتم وضع الإصبع على شاشة تعمل باللمس | |
كائن الحدث
الثوابت
ثابت | وصف | DOM |
---|
CAPTURING_PHASE | المرحلة الحدث الحالية هي مرحلة التقاط (1) | 1 |
AT_TARGET | الحدث الحالي هو في مرحلة الهدف، أي يتم تقييمها في الهدف الحدث (2) | 2 |
BUBBLING_PHASE | المرحلة الحدث الحالية هي مرحلة السطح (3) | 3 |
الخصائص
خاصية | وصف | DOM |
---|
فقاعات | يعود أم لا حدث معين هو حدث محتدما | 2 |
للإلغاء | عودة أم لا حدث يمكن أن يكون الإجراء الافتراضي لها منع | 2 |
currentTarget | إرجاع العنصر الذي تسبب في الحدث المستمعين الحدث | 2 |
defaultPrevented | عودة أم لا preventDefault() تم استدعاء أسلوب لهذا الحدث | 3 |
eventPhase | المرتجعات التي يجري حاليا تقييم المرحلة من تدفق الحدث | 2 |
isTrusted | يعود وجود أو غير موثوق حدث | 3 |
استهداف | إرجاع العنصر الذي تسبب في الحدث | 2 |
الطابع الزمني | إرجاع الوقت (in milliseconds relative to the epoch) الذي تم إنشاء الحدث | 2 |
اكتب | إرجاع اسم الحدث | 2 |
رأي | إرجاع مرجع إلى كائن النافذة حيث حدث الحدث | 2 |
أساليب
طريقة | وصف | DOM |
---|
preventDefault() | يلغي هذا الحدث إذا كان للإلغاء، وهذا يعني أن الإجراء الافتراضي الذي ينتمي إلى الحدث لن يحدث | 2 |
stopImmediatePropagation() | يمنع المستمعين آخرين من نفس الحدث من استدعائه | 3 |
stopPropagation() | يمنع مزيد من انتشار حدث خلال تدفق الحدث | 2 |
كائن MouseEvent
خاصية | وصف | DOM |
---|
مفتاح بديل | يعود ما إذا كان "ALT" تم الضغط مفتاح عندما تم تشغيل الحدث الماوس | 2 |
زر | تم الضغط على زر العوائد التي الماوس عندما تم تشغيل الحدث الماوس | 2 |
وصفت | تم الضغط المرتجعات التي أزرار الماوس عندما تم تشغيل الحدث الماوس | 3 |
clientX | إرجاع الأفقي تنسيق مؤشر الماوس، نسبة إلى الإطار الحالي، عندما تم تشغيل الحدث الماوس | 2 |
clientY | إرجاع تنسيق عمودي مؤشر الماوس، نسبة إلى الإطار الحالي، عندما تم تشغيل الحدث الماوس | 2 |
ctrlKey | عوائد ما إذا كان "CTRL" تم الضغط مفتاح عندما تم تشغيل الحدث الماوس | 2 |
التفاصيل | إرجاع الرقم الذي يشير إلى عدد المرات التي تم النقر على الماوس | 2 |
metaKey | عوائد ما إذا كان "META" تم الضغط مفتاح عندما اندلعت حدث | 2 |
الصفحة س | إرجاع الأفقي تنسيق مؤشر الماوس، بالنسبة للوثيقة، عندما تم تشغيل الحدث الماوس | |
الصفحة (ص) | إرجاع تنسيق عمودي مؤشر الماوس، بالنسبة للوثيقة، عندما تم تشغيل الحدث الماوس | |
relatedTarget | إرجاع العنصر ذات الصلة إلى العنصر الذي تسبب في الحدث الماوس | 2 |
screenX | إرجاع الأفقي تنسيق مؤشر الماوس، نسبة إلى الشاشة، وعندما اندلعت حدث | 2 |
screenY | إرجاع تنسيق عمودي مؤشر الماوس، نسبة إلى الشاشة، وعندما اندلعت حدث | 2 |
shiftKey | يعود ما إذا كان "SHIFT" تم الضغط مفتاح عندما اندلعت حدث | 2 |
التي | تم الضغط على زر العوائد التي الماوس عندما تم تشغيل الحدث الماوس | 2 |
كائن KeyboardEvent
خاصية | وصف | DOM |
---|
مفتاح بديل | يعود ما إذا كان "ALT" تم الضغط مفتاح عندما تم تشغيل الحدث الرئيسي | 2 |
ctrlKey | يعود ما إذا كان "CTRL" تم الضغط مفتاح عندما تم تشغيل الحدث الرئيسي | 2 |
charCode | يعود رمز حرف Unicode من المفتاح الذي تشغيل الحدث onkeypress | 2 |
مفتاح | إرجاع قيمة المفتاح من المفتاح الذي يمثله الحدث | 3 |
رمز المفتاح | يعود رمز حرف Unicode من المفتاح الذي تشغيل الحدث onkeypress، أو يونيكود رمز مفتاح من المفتاح الذي تسبب في عند_ضغط_مفتاح أو حدث onkeyup | 2 |
موقعك | يعود موقع مفتاح على لوحة المفاتيح أو جهاز | 3 |
metaKey | عوائد ما إذا كان "meta" تم الضغط مفتاح عندما تم تشغيل الحدث الرئيسي | 2 |
shiftKey | يعود ما إذا كان "SHIFT" تم الضغط مفتاح عندما تم تشغيل الحدث الرئيسي | 2 |
التي | يعود رمز حرف Unicode من المفتاح الذي تشغيل الحدث onkeypress، أو يونيكود رمز مفتاح من المفتاح الذي تسبب في عند_ضغط_مفتاح أو حدث onkeyup | 2 |
كائن HashChangeEvent
خاصية | وصف | DOM |
---|
NEWURL | إرجاع URL من الوثيقة، بعد أن تم تغيير التجزئة | |
OLDURL | إرجاع URL للوثيقة، قبل أن تغير التجزئة | |
كائن PageTransitionEvent
خاصية | وصف | DOM |
---|
استمر | إرجاع سواء كان مؤقتا صفحة ويب بواسطة مستعرض | |
كائن FocusEvent
خاصية | وصف | DOM |
---|
relatedTarget | إرجاع العنصر ذات الصلة إلى العنصر الذي تسبب في الحدث | 3 |
كائن AnimationEvent
كائن TransitionEvent
كائن WheelEvent
خاصية | وصف | DOM |
---|
deltaX | إرجاع مبلغ التمرير الأفقي من عجلة الماوس (x-axis) | 3 |
deltaY | إرجاع مبلغ التمرير الرأسي للعجلة الماوس (y-axis) | 3 |
deltaZ | إرجاع مبلغ التمرير من عجلة الماوس للمحور Z | 3 |
deltaMode | إرجاع الرقم الذي يمثل وحدة قياس للقيم دلتا (pixels, lines or pages) | 3 |