Vue.js Benutzerdefinierte Direktiven
Zusätzlich zu den standardmäßig festgelegten Kern-Direktiven (v-model und v-show) erlaubt Vue auch das Registrieren benutzerdefinierter Direktiven.
Im Folgenden registrieren wir eine globale Direktive v-focus, die bewirkt, dass das Element den Fokus erhält, wenn die Seite geladen wird:
Beispiel
Selbst ausprobieren »
Wir können auch die Option directives in der Instanz verwenden, um lokale Direktiven zu registrieren, sodass die Direktive nur in dieser Instanz verwendet werden kann:
Beispiel
Selbst ausprobieren »
Hooks
Hook-Funktionen
Die Definitionsfunktion der Direktive stellt mehrere Hook-Funktionen bereit (optional):
bindWird nur einmal aufgerufen, wenn die Direktive erstmals an das Element gebunden wird. Diese Hook-Funktion kann verwendet werden, um eine Initialisierungsaktion zu definieren, die einmal beim Binden ausgeführt wird.insertedWird aufgerufen, wenn das gebundene Element in seinen übergeordneten Knoten eingefügt wird (es muss nur im übergeordneten Knoten vorhanden sein, nicht unbedingt im Dokument).updateWird aufgerufen, wenn das Template, das das gebundene Element enthält, aktualisiert wird, unabhängig davon, ob sich der Bindungswert ändert. Durch den Vergleich des Bindungswerts vor und nach der Aktualisierung können unnötige Template-Aktualisierungen ignoriert werden (siehe unten für detaillierte Parameter der Hook-Funktion).componentUpdatedWird aufgerufen, wenn das Template, das das gebundene Element enthält, einen Aktualisierungszyklus abgeschlossen hat.unbindWird nur einmal aufgerufen, wenn die Direktive vom Element gelöst wird.
Parameter der Hook-Funktion
Die Parameter der Hook-Funktion sind:
- elDas an die Direktive gebundene Element, das verwendet werden kann, um das DOM direkt zu manipulieren.
- bindingEin Objekt mit den folgenden Eigenschaften:
- nameDer Name der Direktive, ohne
v-das Präfix. - valueDer Bindungswert der Direktive, zum Beispiel:
v-my-directive="1 + 1"der Wert von value ist2。 - oldValueDer vorherige, von der Direktive gebundene Wert, nur verfügbar in
updateundcomponentUpdateddem Hook. Er ist verfügbar, unabhängig davon, ob sich der Wert ändert. - expressionDer Ausdruck oder Variablenname des Bindungswerts. Zum Beispiel
v-my-directive="1 + 1"der Wert von expression ist"1 + 1"。 - argDas an die Direktive übergebene Argument. Zum Beispiel
v-my-directive:fooder Wert von arg ist"foo"。 - modifiersEin Objekt, das Modifikatoren enthält. Zum Beispiel:
v-my-directive.foo.barder Wert des modifiers-Objekts ist{ foo: true, bar: true }。
- nameDer Name der Direktive, ohne
- vnodeDer von der Vue-Kompilierung generierte virtuelle Knoten.
- oldVnodeDer vorherige virtuelle Knoten, nur verfügbar in
updateundcomponentUpdateddem Hook.
Das folgende Beispiel demonstriert die Verwendung dieser Parameter:
Beispiel
Selbst ausprobieren »
Manchmal benötigen wir keine anderen Hook-Funktionen, und wir können die Kurzform der Funktion verwenden, wie folgt:
Vue.directive('example', function (el, binding) {
// 设置指令的背景颜色
el.style.backgroundColor = binding.value.color
})
Direktivenfunktionen können alle gültigen JavaScript-Ausdrücke akzeptieren. Das folgende Beispiel übergibt ein JavaScript-Objekt:
Beispiel
Selbst ausprobieren »