Méthode jQuery off()
Exemple
Supprimez l'événement click pour tous les éléments <p> :
$("button").click(function(){
$("p").off("click");
});
Définition et utilisation
La méthode off() est le plus souvent utilisée pour supprimer les gestionnaires d'événements attachés avec la méthode on() .
Depuis la version 1.7 de jQuery, la méthode off() remplace les méthodes unbind(), die() et undelegate(). Cette méthode apporte beaucoup de cohérence à l'API, et nous vous recommandons d'utiliser cette méthode, car elle simplifie la base de code jQuery.
Remarque : Pour supprimer des gestionnaires d'événements spécifiques, la chaîne du sélecteur doit correspondre à celle transmise à la méthode on(), lorsque le gestionnaire d'événements était attaché.
Conseil : Pour attacher un événement qui ne s'exécute qu'une seule fois puis se supprime, utilisez la méthode one() .
Syntaxe
$(selector).off(event,selector,function(eventObj),map)
Parameter | Description |
---|---|
event | Required. Specifies one or more events or namespaces to remove from the selected element(s). Multiple event values are separated by a space. Must be a valid event |
selector | Optional. A selector which should match the one originally passed to the on() method when attaching event handlers |
function(eventObj) | Optional. Specifies the function to run when the event occurs |
map | Specifies an event map ({event:function, event:function, ...}) containing one or more event to attach to the elements, and functions to run when the events occur |
Essayez-le vous-même - Exemples
Comment supprimer tous les gestionnaires d'événements de clic pour tous les éléments <p> ajoutés avec la méthode on().
Comment supprimer une fonction spécifique ajoutée avec la méthode on().
Comment supprimer un gestionnaire d'événements après que l'événement a été déclenché un certain nombre de fois.