HTML DOM removeEventListener()Метод
Пример
Удалите событие "mousemove", добавленное методом addEventListener():
document.addEventListener("mousemove", myFunction);
// Удалить обработчик события из документа
document.removeEventListener("mousemove", myFunction);
Попробуйте сами »
Определение и использование
Метод document.removeEventListener() используется для удаленияdocument.addEventListener()обработчика события, добавленного этим методом.
Примечание:Чтобы удалить обработчик события, функция, переданная в addEventListener(), должна быть внешней функцией, как показано в примере выше (myFunction).
Анонимные функции, такие как "document.removeEventListener("event", function(){ myScript});" событие не может быть удалено.
Совет:Используйте element.addEventListener()иelement.removeEventListener()метод для добавления или удаления обработчиков событий для указанного элемента.
Поддержка браузеров
Числа в таблице указывают первую версию браузера, которая поддерживает метод.
| Метод | |||||
|---|---|---|---|---|---|
| removeEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
Примечание:Internet Explorer 8 и более ранние версии IE не поддерживают метод removeEventListener(), а Opera 7.0 и более ранние версии Opera также его не поддерживают. Однако для этих браузеров, которые не поддерживают эту функцию, можно использоватьdetachEvent()метод для удаления обработчика событий, добавленного методом attachEvent() (см. "Дополнительные примеры" для кроссбраузерного решения).
Синтаксис
Значения параметров
| Параметр | Описание |
|---|---|
| event | Обязательно. Имя события, которое нужно удалить. Примечание:Не используйте префикс "on". Например, используйте "click" вместо "onclick". Совет:Для всех событий HTML DOM см. наш полный справочник объектов событий HTML DOM。 |
| функция | Обязательно. Указывает функцию для удаления. |
| useCapture | Необязательно. Логическое значение, указывающее фазу, в которой нужно удалить обработчик события. Возможные значения:
|
Технические детали
| Версия DOM: | События DOM уровня 2 |
|---|---|
| Возвращаемое значение: | Нет возвращаемого значения |
| Журнал изменений: | В Firefox 6 и Opera 12.0 параметр useCapture необязателен. (В Chrome, IE и Safari он всегда был необязательным). |
Другие примеры
Пример
Если браузер не поддерживает метод removeEventListener(), вместо него можно использовать метод detachEvent().
Этот пример демонстрирует кроссбраузерное решение:
document.removeEventListener("mousemove", myFunction);
} else if (document.detachEvent) { // IE 8 и более ранние версии
document.detachEvent("onmousemove", myFunction);
}
Попробуйте сами »
Связанные статьи
Учебник JavaScript:HTML DOM EventListener
Справочник JavaScript:element.removeEventListener()
Другие расширения
Объект Document