DOM HTML addEventListener()Méthode

Document 对象参考手册Objet Document

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

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

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

document.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, 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 :
  • 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
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 :

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

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

Essayez-le vous-même »

Exemple

Modifiez l'arrière-plan de l'élément <body> :

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

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

if (document.addEventListener) { // Tous les principaux navigateurs, sauf IE 8 et les versions IE antérieures
    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()

Document 对象参考手册Objet Document

Autres extensions