مفهوم Event XML DOM
- الصفحة السابقة عنصر DOM
- الصفحة التالية جمعية DOM HTML
تمثل obj Event معلومات حول الحدث.
obj Event
تقدم خصائص obj Event تفاصيل حول الحدث (مثل العنصر الذي حدث عليه الحدث). يمكن للطرق في obj Event التحكم في نشر الحدث.
حدد معيار DOM Events المستوى الثاني نموذج أحداث قياسي، يتم تنفيذه من قبل جميع المتصفحات الحديثة باستثناء IE، الذي يحدد نموذجًا خاصًا وغير متوافقًا. هذه الصفحة تشمل خصائص obj Event القياسية وخصائص obj Event الخاص بالIE.
ملاحظة:في نموذج أحداث القياسي، يتم تمرير obj Event إلى دالة المستمع إلى الحدث؛ ولكن في نموذج أحداث IE، يتم تخزينه في خاصية event لعنصر Window.
في نموذج أحداث القياسي، تعريف واجهات فرعية مختلفة لـ Event لتقديم تفاصيل متعلقة بأنواع الأحداث المختلفة. في نموذج أحداث IE، هناك نوع واحد فقط من obj Event، ويُستخدم لجميع أنواع الأحداث.
خصائص Event القياسية
فيما يلي قائمة بالخصائص المحددة في معيار أحداث DOM المستوى الثاني.
خصائص | وصف | IE | F | O | W3C |
---|---|---|---|---|---|
bubbles | يعود بقيمة بولية، تُشير إلى ما إذا كان الحدث نوعًا بثًا أو ليس كذلك. | لا | 1 | 9 | نعم |
cancelable | يعود بقيمة بولية، تُشير إلى ما إذا كان الحدث قابلاً للالغاء أو ليس كذلك. | لا | 1 | 9 | نعم |
currentTarget | يعود بالعنصر الذي أثار المستمع إلى الحدث. | لا | 1 | 9 | نعم |
eventPhase | يعود بالمرحلة الحالية لنشر الحدث. | نعم | |||
target | يعود بالعنصر الذي تسبب في حدوث الحدث (النقطة المستهدفة للحدث). | لا | 1 | 9 | نعم |
timeStamp | يعود بوقت ووقت الحدث الذي تم إنشاء الحدث. | لا | 1 | 9 | نعم |
type | يعود بنوع الحدث الذي يمثله obj Event الحالي. | 6 | 1 | 9 | نعم |
طرق Event القياسية
فيما يلي قائمة بالطرق المحددة في معيار أحداث DOM المستوى الثاني. لا يدعم نموذج أحداث IE هذه الطرق:
الطريقة | وصف | IE | F | O | W3C |
---|---|---|---|---|---|
initEvent() | تهيئة خصائص obj Event الجديدة التي تم إنشاؤها. | لا | 1 | 9 | نعم |
preventDefault() | تنبيه المتصفح بعدم تنفيذ الفعل الافتراضي المرتبط بالحدث. | لا | 1 | 9 | نعم |
stopPropagation() | توقف عن نشر الحدث في عملية الاستقطاب أو معالجة الهدف أو مرحلة البث الزائدة من التوزيع. بعد إجراء هذه الدالة، سيتم استدعاء البرنامج المعالج للحدث على هذا العنصر، وسيتم إعادة توزيع الحدث بعد الآن على العناصر الأخرى. | لا | 1 | 9 | نعم |
خصائص IE
لا يدعم IE نموذج أحداث DOM القياسي (على الأقل في IE 7) ويحدد obj Event مجموعة مختلفة تمامًا من الخصائص.
نموذج أحداث IE لا يحدد سلسلة الوراثة للمستويات المختلفة من الأحداث، لذا يتم عرض جميع الخصائص المتعلقة بكل نوع من أنواع الأحداث هنا.
خصائص | وصف |
---|---|
cancelBubble | إذا كان يريد معالج الحدث منع انتقال الحدث إلى العنصر المحتوي، يجب إعداد هذا الخصائص إلى true. |
fromElement | للمواقف التي تتعلق بحدوث أحداث mouseover وmouseout، يتم استدعاء هذا الخصائص إلى العنصر الذي يخرج منه الفأرة. |
keyCode |
للمواقف التي تتعلق بحدوث أحداث keypress، يتم تحديد رمز الحرف الناتج عن الضرب على الزر. للمواقف التي تتعلق بحدوث أحداث keydown وkeyup، يتم تحديد رمز المفتاح الافتراضي للزر الذي تم ضربه. قد تكون الرموز المفاتيح الافتراضية مرتبطة بنظام التخطيط للآلة الحاسبة التي تستخدمها. |
offsetX,offsetY | موقع حدوث الحدث في نظام الإحداثيات للعنصر المصدر للحدث في إحداثيات x وy. |
returnValue |
إذا تم تعيين هذا الخصائص، فإن قيمته تملك أولوية أعلى من قيمة العنصر الذي يعالج الحدث. بإعداد هذا الخصائص إلى fasle، يمكنك إلغاء الحركة الافتراضية للعنصر المصدر للحدث. |
srcElement | للمواقف التي تتعلق بحدوث أحداث Window أو Document أو Element، يتم استدعاء هذا الخصائص إلى العنصر الذي تم إنشاء الحدث. |
toElement | للمواقف التي تتعلق بحدوث أحداث mouseover وmouseout، يتم استدعاء هذا الخصائص إلى العنصر الذي يدخل فيه الفأرة. |
x,y | موقع حدوث الحدث في إحداثيات x وy، وهي مطلقة بالنسبة للأعلى العنصر الذي تم تحديد موقعه بشكل ديناميكي باستخدام CSS. |
- الصفحة السابقة عنصر DOM
- الصفحة التالية جمعية DOM HTML