DOM HTML addEventListener()Méthode
Exemple
Ajoutez un événement click à un élément <button>. Lorsque l'utilisateur clique sur le bouton, affichez "Hello World" dans un élément <p> avec id="demo" :
document.getElementById("demo").innerHTML = "Hello World";
});
Essayez-le vous-même »
Définition et utilisation
La méthode addEventListener() est utilisée pour attacher un gestionnaire d'événements à l'élément spécifié.
Astuce :Utilisez la méthoderemoveEventListener()pour supprimer un gestionnaire d'événements ajouté par la méthode addEventListener().
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 antérieures d'IE ne prennent pas en charge la méthode addEventListener(), et Opera 7.0 ainsi que les versions antérieures d'Opera ne la prennent pas en charge non plus. Toutefois, pour ces navigateurs qui ne prennent pas en charge cette fonction, vous pouvez utiliserattachEvent(), la méthode pour ajouter un gestionnaire d'événements (voir « Plus d'exemples » pour une solution multi-navigateurs).
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, vous pouvez consulter notre complèteréférence des objets d'événements HTML DOM。 |
| fonction | Obligatoire. Spécifie la fonction à exécuter lorsque l'événement est déclenché. Lorsque l'objet événement est passé dans la fonction comme premier paramètre. Le type de l'objet é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 doit être exécuté dans la phase de capture ou de propagation. Valeurs possibles :
|
Détails techniques
| Version DOM : | Événements DOM niveau 2 |
|---|---|
| Valeur de retour : | Aucune valeur de retour |
| Notes : | Dans Firefox 6 et Opera 11.60, le paramètre useCapture est facultatif. (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.
Cet exemple montre comment exécuter une fonction lorsque l'utilisateur clique sur un élément <button> :
function myFunction() {
document.getElementById("demo").innerHTML = "Hello World";
}
Essayez-le vous-même »
Exemple
Vous pouvez ajouter de nombreux événements au document ; les événements ajoutés n'écraseront pas les événements existants.
Cet exemple montre comment ajouter deux événements de clic à un élément <button> :
document.getElementById("myBtn").addEventListener("click", someOtherFunction);
Essayez-le vous-même »
Exemple
Vous pouvez ajouter différents types d'événements au même élément.
Cet exemple montre comment ajouter plusieurs événements au même élément <button> :
document.getElementById("myBtn").addEventListener("click", someOtherFunction);
document.getElementById("myBtn").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
Modifier l'arrière-plan d'un élément <button> :
this.style.backgroundColor = "red";
});
Essayez-le vous-même »
Exemple
Utilisez le paramètre facultatifuseCapturepour démontrer la différence entre les phases de propagation montante et de capture :
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.getElementById("myDIV").addEventListener("mousemove", myFunction);
// Supprimer le gestionnaire d'événement du <div>
document.getElementById("myDIV").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 :
if (x.addEventListener) { // Tous les principaux navigateurs, sauf IE 8 et les versions antérieures d'IE
x.addEventListener("click", myFunction);
} else if (x.attachEvent) { // IE 8 et versions antérieures d'IE
x.attachEvent("onclick", myFunction);
}
Essayez-le vous-même »
Pages associées
Tutoriel JavaScript :HTML DOM EventListener
Référence JavaScript :document.addEventListener()
Autres extensions
Objet Element