HTML DOM addEventListener()Method
Пример
Добавьте событие click к документу. Когда пользователь щелкнет в любом месте документа, выведите "Hello World" в элементе <p> с id="demo":
Попробуйте сами »
Определение и использование
Метод 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()метод для добавления обработчиков событий (по вопросам кроссбраузерной совместимости см. "Больше примеров").
Синтаксис
Значения параметров
| Параметр | Описание |
|---|---|
| event | Обязательно. Строка, указывающая имя события. Примечание:Не используйте префикс "on". Например, используйте "click" вместо "onclick". Совет:Для всех событий HTML DOM смотрите наше полноесправочное руководство по объектам событий HTML DOM。 |
| функция | Обязательный. Описывает функцию, выполняемую при срабатывании события. Когда событие срабатывает, объект события передаётся в функцию в качестве первого параметра. Тип объекта события зависит от конкретного события. Например, событие "click" принадлежит объекту MouseEvent. |
| useCapture | Необязательный. Логическое значение, указывающее, выполняется ли событие в фазе перехвата или всплытия. Возможные значения:
|
Технические детали
| Версия DOM: | События DOM Level 2 |
|---|---|
| Возвращаемое значение: | Нет возвращаемого значения |
| Журнал изменений: | Параметр useCapture является необязательным в Firefox 6 и Opera 11.60. (В Chrome, IE и Safari он всегда был необязательным). |
Другие примеры
Пример
Вы можете ссылаться на внешнюю функцию по её имени:
function myFunction() {
document.getElementById("demo").innerHTML = "Hello World";
}
Попробуйте сами »
Пример
Вы можете добавить в документ множество событий, и добавленные события не перезапишут существующие события.
В этом примере показано, как добавить к документу два события click:
document.addEventListener("click", someOtherFunction);
Попробуйте сами »
Пример
Вы можете добавлять к документу различные типы событий.
В этом примере показано, как добавить к документу несколько событий:
document.addEventListener("click", someOtherFunction);
document.addEventListener("mouseout", someOtherFunction);
Попробуйте сами »
Пример
При передаче значений параметров используйте "анонимную функцию" для вызова функции с параметрами:
myFunction(p1, p2);
});
Попробуйте сами »
Пример
Измените фон элемента <body>:
document.body.style.backgroundColor = "red";
});
Попробуйте сами »
Пример
Используйте метод removeEventListener(), чтобы удалить обработчик события, добавленный методом addEventListener():
document.addEventListener("mousemove", myFunction);
// Удалить обработчик событий документа
document.removeEventListener("mousemove", myFunction);
Попробуйте сами »
Пример
Если браузер не поддерживает метод addEventListener(), можно вместо него использовать метод attachEvent().
Следующий пример демонстрирует кроссбраузерное решение:
document.addEventListener("click", myFunction);
} else if (document.attachEvent) { // IE 8 и более ранние версии IE
document.attachEvent("onclick", myFunction);
}
Попробуйте сами »
Связанные страницы
Учебник JavaScript:HTML DOM EventListener
Справочное руководство JavaScript:element.addEventListener()
Другие расширения
Объект Document