HTML DOM removeEventListener()Метод

Document 对象参考手册Объект Document

Пример

Удалите событие "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() (см. "Дополнительные примеры" для кроссбраузерного решения).


Синтаксис

document.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().

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

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

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


Связанные статьи

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

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


Document 对象参考手册Объект Document

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