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

<div id="app"> <p>Al cargar la página, el elemento input obtiene automáticamente el foco:</p> <input v-focus> </div> <script>// Registrar una directiva personalizada global v-focus Vue.directive('focus', { // Cuando el elemento vinculado se inserta en el DOM. inserted: function (el) { // Enfocar el elemento el.focus() } }) // Crear la instancia raíz new Vue({ el: '#app' })</script>

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

<div id="app"> <p>Al cargar la página, el elemento input obtiene automáticamente el foco:</p> <input v-focus> </div> <script>// Crear la instancia raíz new Vue({ el: '#app', directives: { // Registrar una directiva personalizada local v-focus focus: { // Definición de la directiva inserted: function (el) { // Enfocar el elemento el.focus() } } } })</script>

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 incluirv-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 enupdateycomponentUpdatedel gancho. Está disponible sin importar si el valor ha cambiado.
    • expression: La expresión o nombre de variable del valor vinculado. Por ejemplov-my-directive="1 + 1", el valor de expression es"1 + 1"。
    • arg: El parámetro pasado a la directiva. Por ejemplov-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 }。
  • vnode: El nodo virtual generado por la compilación de Vue.
  • oldVnode: El nodo virtual anterior, solo disponible enupdateycomponentUpdatedel gancho.

El siguiente ejemplo demuestra el uso de estos parámetros:

Ejemplo

<div id="app" v-ejemplo:hello.a.b="message"> </div> <script> Vue.directive('ejemplo', { bind: function (el, binding, vnode) { var s = JSON.stringify el.innerHTML = 'name: ' + s(binding.name) + '<br>' + 'value: ' + s(binding.value) + '<br>' + 'expression: ' + s(binding.expression) + '<br>' + 'argument: ' + s(binding.arg) + '<br>' + 'modifiers: ' + s(binding.modifiers) + '<br>' + 'vnode keys: ' + Object.keys(vnode).join(', ') } }) new Vue({ el: '#app', data: { message: '¡Tutorial para novatos!' } })</script>

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

<div id="app"> <div v-ejemplo="{ color: 'green', text: '¡Tutorial para novatos!' }"></div> </div> <script>Vue.directive('ejemplo', function (el, binding) { // Establece el texto y el color de fondo de forma abreviada el.innerHTML = binding.value.text el.style.backgroundColor = binding.value.color }) new Vue({ el: '#app' })</script>

Pruébalo »
Otras extensiones