Méthode on()de jQuery
Méthodes d'événements jQueryExemples
Ajoutez un gestionnaire d'événement click à l'élément <p> :
Essayez-le vous-même »
Définition et utilisation
La méthode on() ajoute un ou plusieurs gestionnaires d'événements aux éléments sélectionnés et à leurs éléments enfants.
À partir de jQuery version 1.7, la méthode on() est le nouveau remplacement des méthodes bind(), live() et delegate(). Cette méthode apporte de nombreux avantages à l'API, et nous recommandons de l'utiliser, car elle simplifie la base de code jQuery.
Remarque :Les gestionnaires d'événements ajoutés à l'aide de la méthode on() fonctionnent à la fois pour les éléments actuels et futurs (tels que les nouveaux éléments créés par script).
Astuce :Pour supprimer des gestionnaires d'événements, utilisez la méthodeoff().
Astuce :Pour ajouter un événement qui s'exécute une seule fois puis le supprimer, utilisez la méthodeone().
Syntaxe
| Paramètre | Description |
|---|---|
| event | Obligatoire. Spécifie un ou plusieurs événements ou espaces de noms à attacher aux éléments sélectionnés. Plusieurs valeurs d'événement sont séparées par des espaces, ou il peut s'agir d'un tableau. Doit être un événement valide. |
| childSelector | Facultatif. Spécifie que le gestionnaire d'événements ne peut être ajouté qu'aux éléments enfants spécifiés (et non au sélecteur lui-même, comme la méthode delegate() obsolète). |
| data | Facultatif. Spécifie des données supplémentaires à transmettre à la fonction. |
| fonction | Facultatif. Spécifie la fonction à exécuter lorsque l'événement se produit. |
Plus d’exemples
Remplacer bind() par on()
Comment utiliser on() pour obtenir le même effet que bind().
Remplacer delegate() par on()
Comment utiliser on() pour obtenir le même effet que delegate().
Remplacer live() par on()
Comment utiliser on() pour obtenir le même effet que live().
Ajout de plusieurs gestionnaires d'événements
Comment ajouter plusieurs gestionnaires d'événements à un élément.
Ajout de plusieurs gestionnaires d'événements à l'aide du paramètre map
Comment ajouter plusieurs gestionnaires d'événements aux éléments sélectionnés à l'aide du paramètre map.
Ajout d'événements personnalisés aux éléments
Comment ajouter des événements personnalisés avec espace de noms aux éléments.
Transmission de données à la fonction
Comment passer des données à une fonction.
Ajout de gestionnaires d'événements à des éléments futurs
Montre que la méthode on() fonctionne aussi pour les éléments qui n'ont pas encore été créés.
Suppression des gestionnaires d'événements
Comment utiliser la méthode off() pour supprimer des gestionnaires d'événements.
Autres extensions