DOM HTML addEventListener()Méthode
Exemple
Ajoutez un événement click au document. Lorsque l'utilisateur clique n'importe où dans le document, affichez "Hello World" sur l'élément <p> avec id="demo" :
Essayez-le vous-même »
Définition et utilisation
La méthode document.addEventListener() est utilisée pour ajouter un gestionnaire d'événements au document.
Astuce :Vous pouvez utiliser la document.removeEventListener()méthode pour supprimer le gestionnaire d'événements ajouté par la méthode addEventListener().
Astuce :Utilisez la element.addEventListener()méthode pour ajouter un gestionnaire d'événements à l'élément spécifié.
Prise en charge des navigateurs
Les nombres dans le tableau spécifient la première version de navigateur qui prend entièrement en charge la méthode.
| Méthode | |||||
|---|---|---|---|---|---|
| addEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
Remarque :Internet Explorer 8 et les versions IE antérieures ne prennent pas en charge la méthode addEventListener(), et Opera 7.0 et les versions Opera antérieures ne la prennent pas en charge non plus. Toutefois, pour ces versions de navigateur, vous pouvez utiliser laattachEvent()méthode pour ajouter des gestionnaires d'événements (pour les problèmes de compatibilité entre navigateurs, voir « Plus d'exemples »).
Syntaxe
Valeurs des paramètres
| Paramètre | Description |
|---|---|
| event | Obligatoire. Une chaîne qui spécifie le nom de l'événement. Remarque :N'utilisez pas le préfixe "on". Par exemple, utilisez "click" au lieu de "onclick". Astuce :Pour tous les événements HTML DOM, consultez notre manuel de référence completManuel de référence des objets d'événement HTML DOM。 |
| fonction | Obligatoire. Décrit la fonction à exécuter lorsque l'événement est déclenché. Lorsque l'événement est déclenché, l'objet d'événement est transmis à la fonction comme premier paramètre. Le type de l'objet d'événement dépend de l'événement spécifique. Par exemple, l'événement "click" appartient à l'objet MouseEvent. |
| useCapture | Facultatif. Une valeur booléenne qui spécifie si l'événement est exécuté dans la phase de capture ou de bouillonnement. Valeurs possibles :
|
Détails techniques
| Version DOM : | Événements DOM niveau 2 |
|---|---|
| Valeur de retour : | Aucune valeur de retour |
| Journal des modifications : | Le paramètre useCapture est facultatif dans Firefox 6 et Opera 11.60. (Il a toujours été facultatif dans Chrome, IE et Safari). |
Plus d’exemples
Exemple
Vous pouvez référencer une fonction externe par son nom :
function myFunction() {
document.getElementById("demo").innerHTML = "Hello World";
}
Essayez-le vous-même »
Exemple
Vous pouvez ajouter de nombreux événements au document, et les événements ajoutés n'écraseront pas les événements existants.
Cet exemple montre comment ajouter deux événements click au document :
document.addEventListener("click", someOtherFunction);
Essayez-le vous-même »
Exemple
Vous pouvez ajouter différents types d'événements au document.
Cet exemple montre comment ajouter plusieurs événements au document :
document.addEventListener("click", someOtherFunction);
document.addEventListener("mouseout", someOtherFunction);
Essayez-le vous-même »
Exemple
Lorsque vous passez des valeurs de paramètres, utilisez une "fonction anonyme" pour appeler une fonction avec des paramètres :
myFunction(p1, p2);
});
Essayez-le vous-même »
Exemple
Modifiez l'arrière-plan de l'élément <body> :
document.body.style.backgroundColor = "red";
});
Essayez-le vous-même »
Exemple
Utilisez la méthode removeEventListener() pour supprimer un gestionnaire d'événements ajouté par la méthode addEventListener() :
document.addEventListener("mousemove", myFunction);
// Supprimer le gestionnaire d'événement du document
document.removeEventListener("mousemove", myFunction);
Essayez-le vous-même »
Exemple
Si le navigateur ne prend pas en charge la méthode addEventListener(), vous pouvez utiliser la méthode attachEvent() à la place.
L'exemple suivant présente une solution multi-navigateurs :
document.addEventListener("click", myFunction);
} else if (document.attachEvent) { // IE 8 et versions IE antérieures
document.attachEvent("onclick", myFunction);
}
Essayez-le vous-même »
Pages associées
Tutoriel JavaScript :HTML DOM EventListener
Manuel de référence JavaScript :element.addEventListener()
Autres extensions
Objet Document