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