Latest web development tutorials

méthode HTML DOM removeEventListener ()

Document Object Reference Document Object

Exemples

Retirer la méthode addEventListener () pour ajouter l'événement "mousemove":

// Ajouter les gestionnaires d'événements dans le document
document.addEventListener ( "mousemove", myFunction);

// Retirez le gestionnaire d'événements de documents
document.removeEventListener ( "mousemove", myFunction);

Essayez »

Définitions et utilisation

méthode document.removeEventListener () est utilisée pour enlever le document.addEventListener () méthode pour ajouter des gestionnaires d'événements.

Remarque: Si vous souhaitez supprimer le gestionnaire d'événements, addEventListener () la mise en œuvre de la fonction doit utiliser une fonction externe, comme l'exemple montré (myFunction).

Anonyme fonction, similaire à "document.removeEventListener (" event ", la fonction () {myScript});" Cet événement ne peut pas être enlevé.

Astuce: Utilisez élément .addEventListener () et élément .removeEventListener () méthode pour ajouter ou supprimer les gestionnaires d'événements d'éléments spécifiés.


support du navigateur

Les chiffres du tableau représentent le premier navigateur pour soutenir le numéro de version de la méthode.

manière
removeEventListener () 1.0 9.0 1.0 1.0 7.0

Remarque: Internet Explorer 8 et les versions antérieures ne prennent pas en charge la méthode IE removeEventListener (), Opera 7.0 et les versions antérieures ne prennent pas en charge Opera. Cependant, ils ne prennent pas en charge la fonction du navigateur, vous pouvez utiliser la méthode detachEvent () pour supprimer la méthode attachEvent () pour ajouter un gestionnaire d'événements (voir "Autres exemples" pour une solution cross-browser).


grammaire

document.removeEventListener (événement, fonction, useCapture)

Paramètre Valeur

Paramètres description
événement Must. Pour supprimer le nom de l'événement.

Note: Ne pas utiliser le préfixe "on". Par exemple, utiliser "cliquez sur", au lieu de "onclick".

Astuce: Tous les événements HTML DOM, vous pouvez voir notre complète HTML DOM Event Object Reference .
fonction Must. Spécifiez la fonction à supprimer.
useCapture Optionnel. Valeur booléenne indiquant supprimer l'étape de gestionnaire d'événements.

Valeurs possibles:
  • vrai - gestionnaire d'événements est enlevé pendant la phase de capture
  • défaut faux-. Retirez le gestionnaire d'événements pour la phase bullage
Remarque: Si vous ajoutez un gestionnaire d'événement à deux reprises, une fois au cours de la phase de capture, une fois dans la phase de propagation, vous devez supprimer l'événement.

détails techniques

Version DOM: Niveau DOM 2 événements
Retours: Aucune valeur de retour
records: Dans Firefox 6 et Opera 12.0 en useCapture paramètre est facultatif. (Dans Chrome, IE et Safari a toujours été en option).


D'autres exemples

Exemples

Si votre navigateur ne supporte pas la méthode removeEventListener (), vous pouvez utiliser detachEvent (méthodes).

Cet exemple illustre la solution multi-navigateur:

if (document.removeEventListener) {// tous les navigateurs sauf IE 8 et les versions antérieures de IE
document.removeEventListener ( "mousemove", myFunction);
} Else if (document.detachEvent) {// IE 8 et les versions antérieures de IE
document.detachEvent ( "onmousemove", myFunction);
}

Essayez »


articles connexes

JavaScript tutoriel: le code HTML DOM EventListener A

JavaScript Manuel de référence: Element .removeEventListener ()


Document Object Reference Document Object