إزالة مستند HTML DOMEventListener ()
مثال
قم بإزالة حدث "mousemove" الذي تم إرفاقه بطريقة addEventListener ():
// Attach an event handler to the document
document.addEventListener("mousemove", myFunction);
// Remove the event handler from the document
document.removeEventListener("mousemove", myFunction);
المزيد من الأمثلة "جربها بنفسك" أدناه.
التعريف والاستخدام
تزيل طريقة document.removeEventListener () معالج حدث تم إرفاقه مع أسلوب document.addEventListener () .
ملاحظة: لإزالة معالجات الأحداث ، يجب أن تكون الوظيفة المحددة بطريقة addEventListener () دالة خارجية "مسماة" ، كما في المثال أعلاه (myFunction).
الدوال المجهولة ، مثل "document.removeEventListener (" event "، function () { myScript })؛" لن يعمل.
تلميح: استخدم الأسلوبين .addEventListener () والعنصر .removeEventListener () لإضافة / إزالة معالجات الأحداث إلى / من عنصر محدد.
بناء الجملة
document.removeEventListener(event, function, useCapture)
قيمه المعامل
| Parameter | Description |
|---|---|
| event | Required. A String that specifies the name of the event to remove. Note: Do not use the "on" prefix. For example, use "click" instead of "onclick". Tip: For a list of all HTML DOM events, look at our complete HTML DOM Event Object Reference. |
| function | Required. Specifies the function to remove. |
| useCapture |
Optional. A Boolean value that specifies the event phase
to remove the event handler from. Possible values:
|
تفاصيل تقنية
| إصدار DOM: | أحداث DOM المستوى 2 |
|---|---|
| قيمة الإرجاع: | لا قيمة مردودة |
| التغيير: | أصبحت المعلمة useCapture اختيارية في Firefox 6 و Opera 12.0 (كانت دائمًا اختيارية لمتصفحات Chrome و IE و Safari) |
مزيد من الأمثلة
مثال
بالنسبة للمتصفحات التي لا تدعم طريقة removeEventListener () ، يمكنك استخدام طريقة detachEvent ().
يوضح هذا المثال حلاً عبر المستعرضات:
if (document.removeEventListener) { // For all major browsers, except IE 8 and earlier
document.removeEventListener("mousemove", myFunction);
} else if (document.detachEvent) { // For IE 8 and earlier versions
document.detachEvent("onmousemove", myFunction);
}
الصفحات ذات الصلة
دروس جافا سكريبت: HTML DOM EventListener
مرجع JavaScript: element .removeEventListener ()
دعم المتصفح
document.removeEventListener()هي ميزة DOM من المستوى 2 (2001).
إنه مدعوم بالكامل في جميع المتصفحات:
| Chrome | IE | Edge | Firefox | Safari | Opera |
| Yes | 9-11 | Yes | Yes | Yes | Yes |