jQuery on()Methode
Beispiele
Fügen Sie dem <p>-Element einen Klick-Event-Handler hinzu:
Selbst ausprobieren »
Definition und Verwendung
Die on()-Methode fügt den ausgewählten Elementen und deren untergeordneten Elementen einen oder mehrere Event-Handler hinzu.
Seit jQuery Version 1.7 ist die on()-Methode der neue Ersatz für die Methoden bind(), live() und delegate(). Diese Methode bringt viele Annehmlichkeiten in die API, und wir empfehlen, sie zu verwenden, da sie die jQuery-Codebasis vereinfacht.
Hinweis:Mit der on()-Methode hinzugefügte Event-Handler funktionieren sowohl für aktuelle als auch für zukünftige Elemente (wie z. B. neue Elemente, die per Skript erstellt wurden).
Tipp:Um Event-Handler zu entfernen, verwenden Sie dieoff()Methode.
Tipp:Um ein Ereignis hinzuzufügen, das nur einmal ausgeführt und dann entfernt wird, verwenden Sie dieone()-Methode.
Syntax
| Parameter | Beschreibung |
|---|---|
| event | Erforderlich. Gibt ein oder mehrere Ereignisse oder Namespaces an, die an die ausgewählten Elemente angehängt werden sollen. Mehrere Ereigniswerte werden durch Leerzeichen getrennt, oder es kann ein Array sein. Muss ein gültiges Ereignis sein. |
| childSelector | Optional. Gibt an, dass der Event-Handler nur zu den angegebenen untergeordneten Elementen hinzugefügt werden kann (und nicht zum Selektor selbst, wie bei der veralteten Methode delegate()). |
| data | Optional. Gibt zusätzliche Daten an, die an die Funktion übergeben werden. |
| Funktion | Optional. Gibt die Funktion an, die ausgeführt werden soll, wenn das Ereignis eintritt. |
Weitere Beispiele
bind() durch on() ersetzen
Wie man on() verwendet, um denselben Effekt wie mit bind() zu erzielen.
delegate() durch on() ersetzen
Wie man on() verwendet, um denselben Effekt wie mit delegate() zu erzielen.
live() durch on() ersetzen
Wie man on() verwendet, um denselben Effekt wie mit live() zu erzielen.
Mehrere Event-Handler hinzufügen
Wie man einem Element mehrere Event-Handler hinzufügt.
Mehrere Event-Handler mithilfe des map-Parameters hinzufügen
Wie man mithilfe des map-Parameters mehreren ausgewählten Elementen mehrere Event-Handler hinzufügt.
Benutzerdefinierte Events zu Elementen hinzufügen
So fügen Sie benutzerdefinierte Namespace-Ereignisse zu Elementen hinzu.
Übergeben von Daten an die Funktion
Wie man Daten an eine Funktion übergibt.
Hinzufügen von Ereignishandlern zu zukünftigen Elementen
Zeigt, dass die on()-Methode auch für Elemente funktioniert, die noch nicht erstellt wurden.
Event-Handler entfernen
Wie man die off()-Methode verwendet, um Event-Handler zu entfernen.
Weitere Erweiterungen
jQuery-Ereignismethoden