Метод 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 уровня 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);
}
Связанные страницы
Учебник по JavaScript: HTML DOM EventListener
Справочник по JavaScript: document.removeEventListener()
❮ Элемент объекта