Vue.js Componentes - Eventos personalizados

El componente padre usa props para pasar datos al componente hijo, pero si el componente hijo quiere devolver los datos, ¡necesita usar eventos personalizados!

Podemos usar v-on para vincular eventos personalizados. Cada instancia de Vue implementa la interfaz de eventos (Events interface), es decir:

  • Usar$on(eventName)Escuchar eventos
  • Usar$emit(eventName)Emitir eventos

Además, el componente padre puede usar v-on directamente en el lugar donde usa el componente hijo para escuchar los eventos que este emite.

En el siguiente ejemplo, el componente hijo está completamente desacoplado de su exterior. Todo lo que hace es emitir un evento interno que le interesa al componente padre.

Ejemplo

<div id="app"> <div id="counter-event-example"> <p>{{ total }}</p> <button-counter v-on:increment="incrementTotal"></button-counter> <button-counter v-on:increment="incrementTotal"></button-counter> </div> </div> <script> Vue.component('button-counter', { template: '<button v-on:click="incrementHandler">{{ counter }}</button>', data: function () { return { counter: 0 } }, methods: { incrementHandler: function () { this.counter += 1 this.$emit('increment') } }, }) new Vue({ el: '#counter-event-example', data: { total: 0 }, methods: { incrementTotal: function () { this.total += 1 } } }) </script>

Pruébalo »

Si deseas escuchar un evento nativo en el elemento raíz de un componente, puedes usar el modificador .native en v-on. Por ejemplo:

<my-component v-on:click.native="doTheThing"></my-component>

data debe ser una función

En el ejemplo anterior, puedes ver que data en el componente button-counter no es un objeto, sino una función:

data: function () {
  return {
    count: 0
  }
}

La ventaja es que cada instancia puede mantener una copia independiente del objeto devuelto. Si data fuera un objeto, afectaría a otras instancias, como se muestra a continuación:

Ejemplo

<div id="components-demo3" class="demo"> <button-counter2></button-counter2> <button-counter2></button-counter2> <button-counter2></button-counter2> </div> <script>var buttonCounter2Data = { count: 0 } Vue.component('button-counter2', { /* data: function () { // data opciónEs unFunción,grupo件No相互Sombra响 return { count: 0 } }, */ data: function () { // data opciónEs unobjeto,puedeSombra响llegarOtrosEjemplos return buttonCounter2Data }, template: '<button v-on:click="count++">Has hecho clic {{ count }} veces.</button>' }) new Vue({ el: '#components-demo3' }) </script>

Pruébalo »

v-model en componentes personalizados

El v-model en un componente utiliza, por defecto, el prop llamado value y el evento llamado input.

<input v-model="parentData">

Equivale a:

<input 
    :value="parentData"
    @input="parentData = $event.target.value"
>

El siguiente ejemplo define el componente personalizado ejemplo-input. El valor inicial de num en el componente padre es 100; cambiar el valor del componente hijo puede actualizar num del componente padre en tiempo real:

Ejemplo

<div id="app"> <ejemplo-input v-model="num"></ejemplo-input> <p>El número ingresado es: {{num}}</p> </div> <script> Vue.component('ejemplo-input', { template: ` <p> <!--Contiene el evento llamado input--> <input ref="input" :value="value" @input="$emit('input', $event.target.value)" > </p>`, props: ['value'], // prop de nombre value }) new Vue({ el: '#app', data: { num: 100, } })</script>

Pruébalo »

Debido a que v-model por defecto pasa value, no checked, para componentes de casillas de verificación o botones de opción, necesitamos usar la opción model. La opción model puede especificar el tipo de evento actual y los props que se pasan.

Ejemplo

<div id="app"> <base-checkbox v-model="lovingVue"></base-checkbox> <div v-show="lovingVue">Si la casilla está marcada, se mostrará.</div> </div> <script>// Registrar Vue.component('base-checkbox', { model: { prop: 'checked', event: 'change' // evento onchange }, props: { checked: Boolean }, template: `<input type="checkbox" v-bind:checked="checked" v-on:change="$emit('change', $event.target.checked)" >` }) // Crear la instancia raíz new Vue({ el: '#app', data: { lovingVue: true } })</script>

Pruébalo »

En el ejemplo, el valor de lovingVue se pasa al prop checked, y cuando <base-checkbox> emite el evento change, el valor de lovingVue también se actualiza.

Otras extensiones