HTML DOM addEventListener()Method

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

Пример

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

document.getElementById("myBtn").addEventListener("click", function(){
    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()метод для добавления обработчика события (см. "Дополнительные примеры" для кросс-браузерного решения).


Синтаксис

element.addEventListener(event, function, useCapture)

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

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

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

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

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

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

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

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


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

Пример

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

В этом примере показано, как выполнить функцию, когда пользователь нажимает на элемент <button>:

document.getElementById("myBtn").addEventListener("click", myFunction);

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

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

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

Пример

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

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

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

Пример

Используйте необязательный параметрuseCapture, чтобы продемонстрировать разницу между фазами всплытия и захвата:

document.getElementById("myDiv").addEventListener("click", myFunction, true);

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

Пример

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

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

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

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

Пример

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

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

var x = document.getElementById("myBtn");
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

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