DOM HTML addEventListener()Méthode

元素对象参考手册Objet Element

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("myBtn").addEventListener("click", function(){
    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

element.addEventListener(event, function, useCapture)

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 :
  • true - Le gestionnaire d'événements s'exécute dans la phase de capture
  • false - Par défaut. Le gestionnaire d'événements s'exécute dans la phase de bouillonnement

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> :

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

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", myFunction);
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("mouseover", myFunction);
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 :

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

Essayez-le vous-même »

Exemple

Modifier l'arrière-plan d'un élément <button> :

document.getElementById("myBtn").addEventListener("click", function(){
    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 :

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

Essayez-le vous-même »

Exemple

Utilisez la méthode removeEventListener() pour supprimer un gestionnaire d'événements ajouté par la méthode addEventListener() :

// Ajouter un gestionnaire d'événement pour <div>
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 :

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


元素对象参考手册Objet Element

Autres extensions