Méthode jQuery on()
Exemple
Attachez un événement click à l'élément <p> :
$("p").on("click", function(){
alert("The paragraph was clicked.");
});
Définition et utilisation
La méthode on() attache un ou plusieurs gestionnaires d'événements pour les éléments sélectionnés et les éléments enfants.
Depuis la version 1.7 de jQuery, la méthode on() est le nouveau remplacement des méthodes bind(), live() et delegate(). 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 : les gestionnaires d'événements attachés à l'aide de la méthode on() fonctionneront à la fois pour les éléments actuels et FUTURS (comme un nouvel élément créé par un script).
Astuce : Pour supprimer les gestionnaires d'événements, utilisez la méthode off() .
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).on(event,childSelector,data,function,map)
| Parameter | Description |
|---|---|
| event | Required. Specifies one or more event(s) or namespaces to attach to the selected elements. Multiple event values are separated by space. Must be a valid event |
| childSelector | Optional. Specifies that the event handler should only be attached to the specified child elements (and not the selector itself, like the deprecated delegate() method). |
| data | Optional. Specifies additional data to pass along to the function |
| function | Required. 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 selected elements, and functions to run when the events occur |
Essayez-le vous-même - Exemples
Comment attacher plusieurs événements à un élément.
Comment attacher plusieurs gestionnaires d'événements aux éléments sélectionnés à l'aide du paramètre map.
Comment attacher un événement d'espace de noms personnalisé sur un élément.
Comment transmettre des données à la fonction.
Montrer que la méthode on() fonctionne également pour les éléments non encore créés.
Comment supprimer un gestionnaire d'événements à l'aide de la méthode off().