Документ HTML DOM removeEventListener()
Пример
Удалите событие «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 уровня 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);
}
Связанные страницы
Учебник по JavaScript: HTML DOM EventListener
Справочник по JavaScript: элемент .removeEventListener()
Поддержка браузера
document.removeEventListener()
является функцией DOM уровня 2 (2001 г.).
Он полностью поддерживается во всех браузерах:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | 9-11 | Yes | Yes | Yes | Yes |