HTML DOM addEventListener()Método
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":
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
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:
|
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:
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", 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("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:
myFunction(p1, p2);
});
Pruébelo »
Ejemplo
Modifique el fondo del elemento <body>:
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():
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:
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()
Otras extensiones
Objeto Document