HTML DOM addEventListener()Method

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

Пример

Добавьте событие click к документу. Когда пользователь щелкнет в любом месте документа, выведите "Hello World" в элементе <p> с id="demo":

document.addEventListener("click", function(){ document.getElementById("demo").innerHTML = "Hello World"; });

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

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

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

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

Совет:Используйте element.addEventListener()метод для добавления обработчика событий к указанному элементу.


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

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

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

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


Синтаксис

document.addEventListener(event, function, useCapture)

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

Параметр Описание
event Обязательно. Строка, указывающая имя события.

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

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

Когда событие срабатывает, объект события передаётся в функцию в качестве первого параметра. Тип объекта события зависит от конкретного события. Например, событие "click" принадлежит объекту MouseEvent.
useCapture Необязательный. Логическое значение, указывающее, выполняется ли событие в фазе перехвата или всплытия.

Возможные значения:
  • true - Обработчик события выполняется в фазе перехвата
  • false - По умолчанию. Обработчик события выполняется в фазе всплытия

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

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


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

Пример

Вы можете ссылаться на внешнюю функцию по её имени:

document.addEventListener("click", myFunction);

function myFunction() {
    document.getElementById("demo").innerHTML = "Hello World";
}

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

Пример

Вы можете добавить в документ множество событий, и добавленные события не перезапишут существующие события.

В этом примере показано, как добавить к документу два события click:

document.addEventListener("click", myFunction);
document.addEventListener("click", someOtherFunction);

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

Пример

Вы можете добавлять к документу различные типы событий.

В этом примере показано, как добавить к документу несколько событий:

document.addEventListener("mouseover", myFunction);
document.addEventListener("click", someOtherFunction);
document.addEventListener("mouseout", someOtherFunction);

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

Пример

При передаче значений параметров используйте "анонимную функцию" для вызова функции с параметрами:

document.addEventListener("click", function() {
    myFunction(p1, p2);
});

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

Пример

Измените фон элемента <body>:

document.addEventListener("click", function(){
    document.body.style.backgroundColor = "red";
});

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

Пример

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

// Добавить обработчик событий к документу
document.addEventListener("mousemove", myFunction);

// Удалить обработчик событий документа
document.removeEventListener("mousemove", myFunction);

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

Пример

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

Следующий пример демонстрирует кроссбраузерное решение:

if (document.addEventListener) { // Все основные браузеры, кроме IE 8 и более ранних версий IE
    document.addEventListener("click", myFunction);
} else if (document.attachEvent) { // IE 8 и более ранние версии IE
    document.attachEvent("onclick", myFunction);
}

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


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

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

Справочное руководство JavaScript:element.addEventListener()

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

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