Vue3 Formularios

En esta sección les presentamos la aplicación de Vue en formularios.

Podemos usar la directiva v-model en formularios<input>、<textarea>y<select>y otros elementos para crear una vinculación de datos bidireccional.

v-model selecciona automáticamente el método correcto para actualizar el elemento según el tipo de control.

v-model ignora los valores iniciales de los atributos value, checked y selected de todos los elementos del formulario, y utiliza los valores iniciales declarados en la opción data.

v-model internamente usa diferentes propiedades y emite diferentes eventos para distintos elementos de entrada:

  • Los elementos text y textarea usanvaluela propiedad yinputel evento;
  • checkbox y radio usancheckedla propiedad ychangeel evento;
  • El campo select utilizarávaluecomo propiedad ychangecomo evento.

Campo de entrada

El ejemplo demuestra el uso de v-model en los elementos input y textarea para lograr un enlace de datos bidireccional:

<div id="app"> <p>Elemento input:</p> <input v-model="message" placeholder="Edítame..."> <p>El mensaje del formulario input es: {{ message }}</p> <p>Elemento textarea:</p> <textarea v-model="message2" placeholder="Entrada de texto de varias líneas..."></textarea> <p>El mensaje del formulario textarea es:</p> <p style="white-space: pre">{{ message2 }}</p> </div> <script>const app = { data() { return { message: '', message2: 'Tutorial para novatos\r\nhttps://www.example.com' } } } Vue.createApp(app).mount('#app')</script>

Pruébalo »
En el área de texto textarea, la interpolación no funciona; se debe usar v-model en su lugar:
<!-- 错误 -->
<textarea>{{ text }}</textarea>

<!-- 正确 -->
<textarea v-model="text"></textarea>

Casilla de verificación

Si es una sola casilla de verificación, el valor es booleano; si son varias, se vinculan a un mismo array:

Casilla de verificación

El siguiente ejemplo demuestra el enlace de datos bidireccional de las casillas de verificación:

<div id="app"> <p>Casilla de verificación individual:</p> <input type="checkbox" id="checkbox" v-model="checked"> <label for="checkbox">{{ checked }}</label> <p>Múltiples casillas de verificación:</p> <input type="checkbox" id="ejemplo" value="Ejemplo" v-model="checkedNames"> <label for="ejemplo">Ejemplo</label> <input type="checkbox" id="google" value="Google" v-model="checkedNames"> <label for="google">Google</label> <input type="checkbox" id="taobao" value="Taobao" v-model="checkedNames"> <label for="taobao">taobao</label> <br> <span>El valor seleccionado es: {{ checkedNames }}</span> </div> <script> const app = { data() { return { checked : false, checkedNames: [] } } } Vue.createApp(app).mount('#app') </script>

Pruébalo »

El efecto de marcar las casillas de verificación en el ejemplo se muestra a continuación:

Botón de opción

El siguiente ejemplo demuestra el enlace de datos bidireccional de los botones de opción:

Botón de opción

<div id="app"> <input type="radio" id="ejemplo" value="Ejemplo" v-model="picked"> <label for="ejemplo">Ejemplo</label> <br> <input type="radio" id="google" value="Google" v-model="picked"> <label for="google">Google</label> <br> <span>El valor seleccionado es: {{ picked }}</span> </div> <script> const app = { data() { return { picked : 'Ejemplo' } } } Vue.createApp(app).mount('#app') </script>

Pruébalo »

Después de seleccionar, el efecto se muestra en la siguiente figura:

Lista select

El siguiente ejemplo demuestra el enlace de datos bidireccional de la lista desplegable:

select

<div id="app"> <select v-model="selected" name="site"> <option value="">Selecciona un sitio web</option> <option value="www.example.com">Ejemplo</option> <option value="www.google.com">Google</option> </select> <div id="output">El sitio web seleccionado es: {{selected}}</div> </div> <script> const app = { data() { return { selected: '' } } } Vue.createApp(app).mount('#app') </script>

Pruébalo »

Al seleccionar Ejemplo, el resultado se muestra a continuación:

Cuando hay selección múltiple, se vincula a un array:

select

<div id="app"> <select v-model="selected" name="fruit" multiple> <option value="www.example.com">Ejemplo</option> <option value="www.google.com">Google</option> <option value="www.taobao.com">Taobao</option> </select> <div id="output">Los sitios web seleccionados son: {{selected}}</div> </div> <script> const app = { data() { return { selected: '' } } } Vue.createApp(app).mount('#app') </script>

Pruébalo »

Selecciona Ejemplo y Google:

Usav-forun bucle para generar las opciones:

select

<div id="app" class="demo"> <select v-model="selected"> <option v-for="option in options" :value="option.value"> {{ option.text }} </option> </select> <span>Lo seleccionado es: {{ selected }}</span> </div> <script> const app = { data() { return { selected: 'www.example.com', options: [ { text: 'Ejemplo', value: 'www.example.com' }, { text: 'Google', value: 'www.google.com' }, { text: 'Taobao', value: 'www.taobao.com' } ] } } } Vue.createApp(app).mount('#app') </script>

Pruébalo »

Selecciona Ejemplo:

Vinculación de valores

Para los botones de opción, las casillas de verificación y las opciones de las listas de selección, el valor vinculado por v-model suele ser una cadena de texto estática (para las casillas de verificación también puede ser un valor booleano):

<!-- Cuando está seleccionado, `picked` es la cadena "a" -->
<input type="radio" v-model="picked" value="a" />

<!-- `toggle` es true o false -->
<input type="checkbox" v-model="toggle" />

<!-- Cuando se selecciona la primera opción, `selected` es la cadena "abc" -->
<select v-model="selected">
  <option value="abc">ABC</option>
</select>

Pero a veces es posible que queramos vincular el valor a una propiedad dinámica de la instancia activa actual; en ese caso se puede usar v-bind. Además, usando v-bind se puede vincular el valor de entrada a un tipo que no sea cadena.

Casilla de verificación (Checkbox):

<input type="checkbox" v-model="toggle" true-value="yes" false-value="no" />
...
// 选中时
vm.toggle === 'yes'
// 取消选中 
vm.toggle === 'no'

Botón de opción (Radio):

<input type="radio" v-model="pick" v-bind:value="a" />
// 当选中时
vm.pick === vm.a

Opciones de selección (Select):

<select v-model="selected">
  <!-- 内联对象字面量 -->
  <option :value="{ number: 123 }">123</option>
</select>
// 当被选中时
typeof vm.selected // => 'object'
vm.selected.number // => 123

Modificadores

.lazy

De forma predeterminada, v-model sincroniza el valor del campo de entrada con los datos en el evento input, pero puedes agregar un modificador lazy para que la sincronización se realice en el evento change:

<!-- 在 "change" 而不是 "input" 事件中更新 -->
<input v-model.lazy="msg" >

.number

Si deseas convertir automáticamente el valor ingresado por el usuario al tipo Number (si el resultado de la conversión es NaN, se devuelve el valor original), puedes agregar un modificador number a v-model para procesar el valor de entrada:

<input v-model.number="age" type="number">

Esto suele ser muy útil, porque cuando type="number", el valor ingresado en HTML siempre se devuelve como tipo cadena.

.trim

Si deseas filtrar automáticamente los espacios en blanco al inicio y al final de la entrada del usuario, puedes agregar el modificador trim a v-model para filtrar la entrada:

<input v-model.trim="msg">
Otras extensiones