Méthodes off()de jQuery
Exemples
Supprimer l’événement clic sur tous les éléments <p> :
Essayez-le »
Définition et utilisation
La méthode off() est généralement utilisée pour supprimer les gestionnaires d'événements ajoutés via la méthodeon().
Depuis jQuery version 1.7, la méthode off() est un nouveau remplacement pour les méthodes unbind(), die() et undelegate(). Cette méthode apporte beaucoup de commodité à l'API. Nous recommandons d'utiliser cette méthode, car elle simplifie la base de code jQuery.
Remarque :Pour supprimer un gestionnaire d'événements spécifique, la chaîne de sélecteur doit correspondre au paramètre passé à la méthode on() lorsque le gestionnaire d'événements a été ajouté.
Astuce :Pour ajouter un événement qui s'exécute une seule fois puis le supprimer, utilisez la méthodeone().
Syntaxe
| Parameters | Description |
|---|---|
| event | Obligatoire. Spécifie un ou plusieurs événements ou espaces de noms à supprimer des éléments sélectionnés. Plusieurs valeurs d'événement sont séparées par des espaces. Doivent être des événements valides. |
| selector | Facultatif. Spécifie le sélecteur transmis à l'origine à la méthode on() lors de l'ajout du gestionnaire d'événements. |
| function(eventObj) | Facultatif. Spécifie la fonction à exécuter lorsque l'événement se produit. |
| map | Spécifie une carte d'événements ({event:function, event:function, ...}), contenant un ou plusieurs événements à ajouter à l'élément, ainsi que la fonction à exécuter lorsque l'événement se produit. |
Plus d’exemples
Passage de unbind() à off()
Comment utiliser off() pour obtenir le même effet que unbind().
Passer de undelegate() à off()
Comment utiliser off() pour obtenir le même effet que undelegate().
Passer de die() à off()
Comment utiliser off() pour obtenir le même effet que die().
Supprimer tous les gestionnaires d'événements click ajoutés via on()
Comment supprimer tous les gestionnaires d'événements click ajoutés à tous les éléments <p> via la méthode on().
Supprimer une fonction d'événement spécifiée ajoutée via on()
Comment supprimer une fonction spécifiée ajoutée via la méthode on().
Supprimer un gestionnaire d'événements à l'aide de l'objet événement
Comment supprimer un gestionnaire d'événements après qu'un événement a été déclenché un certain nombre de fois.
Autres extensions
Méthodes d'événements jQuery