HTML DOM removeEventListener()Метод

元素对象参考手册Объект Element

Примеры

Удалите событие "mousemove", добавленное методом addEventListener():

// Добавить обработчик события к элементу <div>
document.getElementById("myDIV").addEventListener("mousemove", myFunction);

// Удалить обработчик события с элемента <div>
document.getElementById("myDIV").removeEventListener("mousemove", myFunction);

Попробуйте сами »

Определение и использование

Метод removeEventListener() используется для удаления обработчика события, добавленного методомaddEventListener().

Примечание:Если вы хотите удалить обработчик события, функция, выполняемая addEventListener(), должна быть внешней функцией, как показано в примере выше (myFunction).

Анонимные функции, такие как "document.removeEventListener("event", function(){ myScript});" Событие не может быть удалено.

Поддержка браузеров

Числа в таблице указывают первую версию браузера, которая полностью поддерживает этот метод.

Метод
removeEventListener() 1.0 9.0 1.0 1.0 7.0

Примечание:Internet Explorer 8 и более ранние версии IE не поддерживают метод removeEventListener(), а Opera 7.0 и более ранние версии Opera также не поддерживают его. Однако для этих браузеров, которые не поддерживают эту функцию, вы можете использоватьdetachEvent()метод для удаления обработчика события, добавленного методом attachEvent() (см. "Дополнительные примеры" для кроссбраузерного решения).

Синтаксис

element.removeEventListener(event, function, useCapture)

Значения параметров

Параметр Описание
event Обязательно. Имя события, которое нужно удалить.

Примечание:Не используйте префикс "on". Например, используйте "click" вместо "onclick".

Совет:Для всех событий HTML DOM вы можете просмотреть наш полный справочник по объектам событий HTML DOM.
функция Обязательно. Указывает функцию для удаления.
useCapture Необязательно. Логическое значение, указывающее фазу для удаления обработчика события.

Возможные значения:
  • true - Удалить обработчик события на этапе захвата
  • false - По умолчанию. Удалить обработчик события на этапе всплытия
Примечание:Если вы добавили обработчик события дважды, один раз на этапе захвата и один раз на этапе всплытия, вы должны удалить событие отдельно.

Технические детали

Версия DOM: События DOM уровня 2
Возвращаемое значение: Нет возвращаемого значения
Журнал изменений: В Firefox 6 и Opera 12.0 параметр useCapture необязателен. (В Chrome, IE и Safari он всегда был необязательным).

Другие примеры

Пример

Если браузер не поддерживает метод removeEventListener(), вместо него можно использовать метод detachEvent().

Этот пример демонстрирует кроссбраузерное решение:

var x = document.getElementById("myDIV");
if (x.removeEventListener) { // // Все браузеры, кроме IE 8 и более ранних версий IE
    x.removeEventListener("mousemove", myFunction);
} else if (x.detachEvent) { // IE 8 и более ранние версии IE
    x.detachEvent("onmousemove", myFunction);
}

Попробуйте сами »

Связанные страницы

Учебник JavaScript:HTML DOM EventListener

Справочник JavaScript:document.removeEventListener()

元素对象参考手册Объект Element

Другие расширения