طريقة HTML DOM removeEventListener ()
❮ عنصر العنصرمثال
قم بإزالة حدث "mousemove" الذي تم إرفاقه بطريقة addEventListener ():
// Attach an event handler to <div>
document.getElementById("myDIV").addEventListener("mousemove", myFunction);
// Remove the event handler from <div>
document.getElementById("myDIV").removeEventListener("mousemove", myFunction);
التعريف والاستخدام
تزيل طريقة removeEventListener () معالج الأحداث الذي تم إرفاقه بطريقة addEventListener () .
ملاحظة: لإزالة معالجات الأحداث ، يجب أن تكون الوظيفة المحددة بطريقة addEventListener () دالة خارجية ، كما في المثال أعلاه (myFunction).
الدوال المجهولة ، مثل " element .removeEventListener (" event "، function () { myScript })؛" لن يعمل.
دعم المتصفح
تحدد الأرقام الواردة في الجدول إصدار المتصفح الأول الذي يدعم الطريقة بالكامل.
| Method | |||||
|---|---|---|---|---|---|
| removeEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
بناء الجملة
element.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 ().
يوضح هذا المثال حلاً عبر المستعرضات:
var x = document.getElementById("myDIV");
if (x.removeEventListener) { // For all major browsers, except IE 8 and earlier
x.removeEventListener("mousemove", myFunction);
} else if (x.detachEvent) { // For IE 8 and earlier versions
x.detachEvent("onmousemove", myFunction);
}
الصفحات ذات الصلة
دروس جافا سكريبت: HTML DOM EventListener
مرجع JavaScript: document.removeEventListener ()
❮ عنصر العنصر