Vue.js directivas personalizadas
Además de las directivas principales establecidas por defecto (v-model y v-show), Vue también permite registrar directivas personalizadas.
A continuación registramos una directiva global v-focus. La función de esta directiva es que cuando la página se carga, el elemento obtiene el foco:
Ejemplo
Pruébalo »
También podemos usar la opción `directives` en la instancia para registrar directivas locales, de modo que la directiva solo pueda usarse en esta instancia:
Ejemplo
Pruébalo »
Ganchos
Funciones de gancho
La función de definición de directiva proporciona varias funciones de gancho (opcionales):
bind: Se llama solo una vez, cuando la directiva se vincula al elemento por primera vez. Con esta función de gancho se puede definir una acción de inicialización que se ejecute una vez en la vinculación.inserted: Se llama cuando el elemento vinculado se inserta en su nodo padre (basta con que el nodo padre exista, no es necesario que esté en el documento).update: Se llama cuando se actualiza la plantilla donde se encuentra el elemento vinculado, independientemente de si el valor vinculado ha cambiado. Comparando los valores vinculados antes y después de la actualización, se pueden omitir actualizaciones de plantilla innecesarias (ver más abajo los parámetros detallados de las funciones de gancho).componentUpdated: Se llama cuando la plantilla del elemento vinculado completa un ciclo de actualización.unbind: Se llama solo una vez, cuando la directiva se desvincula del elemento.
Parámetros de las funciones de gancho
Las funciones de gancho reciben los siguientes parámetros:
- el: El elemento vinculado a la directiva, que se puede usar para manipular directamente el DOM.
- binding: Un objeto que contiene las siguientes propiedades:
- name: Nombre de la directiva, sin incluir
v-el prefijo. - value: El valor vinculado de la directiva, por ejemplo:
v-my-directive="1 + 1", el valor de value es2。 - oldValue: El valor anterior vinculado por la directiva, solo disponible en
updateycomponentUpdatedel gancho. Está disponible sin importar si el valor ha cambiado. - expression: La expresión o nombre de variable del valor vinculado. Por ejemplo
v-my-directive="1 + 1", el valor de expression es"1 + 1"。 - arg: El parámetro pasado a la directiva. Por ejemplo
v-my-directive:foo, el valor de arg es"foo"。 - modifiers: Un objeto que contiene modificadores. Por ejemplo:
v-my-directive.foo.bar, el valor del objeto de modificadores modifiers es{ foo: true, bar: true }。
- name: Nombre de la directiva, sin incluir
- vnode: El nodo virtual generado por la compilación de Vue.
- oldVnode: El nodo virtual anterior, solo disponible en
updateycomponentUpdatedel gancho.
El siguiente ejemplo demuestra el uso de estos parámetros:
Ejemplo
Pruébalo »
A veces no necesitamos otras funciones de gancho; podemos abreviar la función de la siguiente manera:
Vue.directive('ejemplo', function (el, binding) {
// 设置指令的背景颜色
el.style.backgroundColor = binding.value.color
})
La función de directiva puede aceptar cualquier expresión legal de JavaScript; el siguiente ejemplo pasa un objeto de JavaScript:
Ejemplo
Pruébalo »