HTML DOM addEventListener()Método

Document 对象参考手册Objeto Document

Ejemplo

Agregue un evento de clic al documento. Cuando el usuario haga clic en cualquier parte del documento, muestre "Hello World" en el elemento <p> con id="demo":

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

Pruébelo »

Definición y uso

El método document.addEventListener() se utiliza para agregar un controlador de eventos al documento.

Consejo:Puede usar document.removeEventListener()el método para eliminar el controlador de eventos agregado por el método addEventListener().

Consejo:Use element.addEventListener()el método para agregar un controlador de eventos al elemento especificado.


Soporte del navegador

Los números de la tabla indican el número de versión del primer navegador que admite el método.

Método
addEventListener() 1.0 9.0 1.0 1.0 7.0

Nota:Internet Explorer 8 y versiones anteriores de IE no admiten el método addEventListener(), y Opera 7.0 y versiones anteriores de Opera tampoco lo admiten. Sin embargo, para estas versiones de navegadores puede usarattachEvent()el método para agregar un controlador de eventos (para problemas de compatibilidad entre navegadores, consulte "Más ejemplos").


Sintaxis

document.addEventListener(event, function, useCapture)

Valores de parámetros

Parámetro Descripción
event Requerido. Una cadena que describe el nombre del evento.

Nota:No use el prefijo "on". Por ejemplo, use "click" en lugar de "onclick".

Consejo:Todos los eventos de HTML DOM, puede consultar nuestro completoManual de referencia del objeto HTML DOM Event。
function Requerido. Describe la función que se ejecuta cuando se dispara el evento.

Cuando se dispara el evento, el objeto de evento se pasa a la función como primer parámetro. El tipo del objeto de evento depende del evento específico. Por ejemplo, el evento "click" pertenece al objeto MouseEvent (evento de mouse).
useCapture Opcional. Un valor booleano que especifica si el evento se ejecuta en la fase de captura o de burbujeo.

Valores posibles:
  • true - El controlador de eventos se ejecuta en la fase de captura.
  • false - Valor predeterminado. El controlador de eventos se ejecuta en la fase de burbujeo.

Detalles técnicos

Versión DOM: DOM Level 2 Events
Valor de retorno: No tiene valor de retorno.
Registro de cambios: En Firefox 6 y Opera 11.60, el parámetro useCapture es opcional. (En Chrome, IE y Safari siempre ha sido opcional).


Más ejemplos

Ejemplo

Puede hacer referencia a una función externa por su nombre de función:

document.addEventListener("click", myFunction);

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

Pruébelo »

Ejemplo

Puede agregar muchos eventos al documento; los eventos agregados no sobrescribirán los eventos existentes.

Este ejemplo demuestra cómo agregar dos eventos de clic al documento:

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

Pruébelo »

Ejemplo

Puede agregar diferentes tipos de eventos al documento.

Este ejemplo demuestra cómo agregar múltiples eventos al documento:

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

Pruébelo »

Ejemplo

Cuando se pasan valores de parámetros, use una "función anónima" para llamar a una función con parámetros:

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

Pruébelo »

Ejemplo

Modifique el fondo del elemento <body>:

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

Pruébelo »

Ejemplo

Use el método removeEventListener() para eliminar el controlador de eventos agregado con el método addEventListener():

// Agregar un controlador de eventos al documento
document.addEventListener("mousemove", myFunction);

// Eliminar el controlador de eventos del documento
document.removeEventListener("mousemove", myFunction);

Pruébelo »

Ejemplo

Si el navegador no admite el método addEventListener(), puede usar el método attachEvent() en su lugar.

El siguiente ejemplo demuestra una solución entre navegadores:

if (document.addEventListener) { // todos los navegadores principales, excepto IE 8 y versiones anteriores de IE
    document.addEventListener("click", myFunction);
} else if (document.attachEvent) { // IE 8 y versiones anteriores de IE
    document.attachEvent("onclick", myFunction);
}

Pruébelo »


Páginas relacionadas

Tutorial de JavaScript:HTML DOM EventListener

Manual de referencia de JavaScript:element.addEventListener()

Document 对象参考手册Objeto Document

Otras extensiones