在 Vue 中控制表单输入

绑定表单输入

让我们实现一个组件，渲染一个初始值为 Unknown 的输入表单。用户在输入表单中引入的值会在屏幕上渲染出来。

v-model 很适合实现这样一个组件。将 v-model 与输入表单连接起来需要两个简单的步骤：


    const text = ref()

：作为


    v-model

可响应式的值。


    v-model="text"

：将


    v-model

添加到分配有


    text

的输入表单标签中。

<script setup>
import { ref } from 'vue'
const text = ref('Unknown') // Step 1: create data bus
</script>
<template>
  <!-- Step 2: assign data bus to v-model -->
  <input v-model="text" type="input" />
  <div>{{ text }}</div>
</template>
输入表单包含初始值Unknown。在输入表单里输入一些东西：输入值和屏幕上的文本都会更新。
v-model="text" 在Vue中属于双向绑定数据。
第一个方向的流动发生在初始化过程中。输入值被初始化为Unknown，也就是text的初始值。
第二个方向的流动发生在给输入表单键入值的时候。v-model接受输入框的值，并用它来更新text。
v-model与v-bind
在Vue中，v-bind是另一种数据绑定机制：
<input v-bind:value="text" type="text" />
可以简写为：
<input :value="text" type="text" />
v-model和:value的不同之处是什么？<input :value="value" />是一种单向数据流机制。
为了理解两者的不同之处，让我们将先前的例子从v-model="text"改为:value="text"：
<script setup>
import { ref } from 'vue'
const text = ref('Unknown')
</script>
<template>
  <input :value="text" type="input" />
  <div>{{ text }}</div>
</template>
输入表单的初始值为Unknown。
在输入表单中键入一些字符，然而…屏幕上渲染的文本依旧是Unknown。
:value="text"让数据流仅仅单向流动：从text流向输入表单。当改变数据表单的值时，并不会改变text。
总之，v-model实现了双向数据流，而:value实现了单向数据流。
模拟v-model
尽管两者有差异，但是v-model可以使用:value和@input进行模拟：
<input v-model="text" type="text" />
也可以表示为：
<input :value="text" @input="text = $event.target.value" type="text" />
下面的代码没有使用v-model，但双向数据流仍然生效：
<script setup>
import { ref } from 'vue'
const text = ref('Unknown')
</script>
<template>
  <input 
    :value="text" 
    @input="text = $event.target.value" 
    type="input" 
  <div>{{ text }}</div>
</template>
常规绑定:value="text"开启了第一个流程。
当用户在输入表单中输入时会触发@input="text = $event.target.value"，从而更新text。这就是第二个流程。
使用reactive()绑定
reactive()是Vue里的响应式API，可以让对象具有响应式。
ref()和reactive()的最大不同点就是，ref()可以存储原始值和对象，而reactive()值接受对象。并且reactive()对象可以直接访问，而不需要像ref()那样需要通过.value属性访问。
让我们实现一个具有姓氏和名字的输入表单，并将这些绑定到一个响应式对象的属性上：
<script setup>
import { reactive } from 'vue'
const person = reactive({ firstName: 'John', lastName: 'Smith' })
</script>
<template>
  <input v-model="person.firstName" type="input" />
  <input v-model="person.lastName" type="input" />
  <div>Full name is {{ person.firstName }} {{ person.lastName }}</div>
</template>
const person = reactive({ firstName: '', lastName: '' })创建了一个响应式的对象。
v-model="person.firstName"与名字属性绑定，以及v-model="person.lastName"与姓氏属性绑定。
一个响应式对象的属性可以作为v-model的数据总线。可以使用这种方法来绑定许多输入表单。
绑定不同输入类型
许多其他的输入类型比如说select、textarea、checkbox、radio都可以使用v-model绑定。让我们来试试吧。
Textarea
为textarea绑定一个ref是非常直截了当的。只需要在textarea标签上使用v-model即可：
<script setup>
import { ref } from 'vue'
const longText = ref("Well... here's my story. One morning...")
</script>
<template>
  <textarea v-model="longText" />
  <div>{{ longText }}</div>
</template>
Select
select也就是下拉框，为用户提供了一组预定义的选项供其选择。
绑定下拉框也是非常简单的：
<script setup>
import { ref } from 'vue'
const employeeId = ref('2')
</script>
<template>
  <select v-model="employeeId">
    <option value="1">Jane Doe</option>
    <option value="2">John Doe</option>
    <option value="3">John Smith</option>
  </select>
  <div>Selected id: {{ employeeId }}</div>
</template>
employeeId是与select绑定的ref，将获得被选择的选项的值。
因为employeeId被初始化为'2'，因此John Doe选项会被选中。
当你选择另一个选项时，你可以看到employeeId以新选择的选项值进行更新。
如果select的选项没有value属性，那么就用选项的文本值进行绑定：
<script setup>
import { ref } from 'vue'
const employee = ref('Jane Doe')
</script>
<template>
  <select v-model="employee">
    <option>Jane Doe</option>
    <option>John Doe</option>
    <option>John Smith</option>
  </select>
  <div>Selected: {{ employee }}</div>
</template>
现在，绑定直接与选项的文本值共同生效。如果你选择了第二个选项，那么employee将被分配为"John Doe"。
Checkbox
感谢v-model让绑定复选框很容易：
<input ref="checked" type="checkbox" />
checked被赋予一个布尔值，表示该复选框是否被选中。
让我们创建一个复选框，并绑定checked：
<script setup>
import { ref } from 'vue'
const checked = ref(true)
</script>
<template>
  <label><input v-model="checked" type="checkbox" />Want a pizza?</label>
  <div>{{ checked }}</div>
</template>
checked的初始值是true，因此复选框默认是被选中的。勾选或不勾选复选框，会相应地将checked更新为true或false。
为了将勾选或不勾选绑定到布尔值以外的其他自定义值，Vue在复选框上提供了2个Vue特有的属性：
<input 
  v-model="checked" 
  true-value="Yes!" 
  false-value="No" 
现在，checked被赋值为'Yes!'或'No'字符串，这取决于复选框的状态。
让我们使用自定义值'Yes!'和'No'来修改先前的例子：
<script setup>
import { ref } from 'vue'
const answer = ref('Yes!')
</script>
<template>
  <label>
    <input v-model="answer" type="checkbox" true-value="Yes!" false-value="No"  />
    Want a pizza?
  </label>
  <div>{{ answer }}</div>
</template>
现在，answer是'Yes!'或'No'取决于复选框的选中状态。
Radio
要绑定一组单选按钮，要对该单选组应用相同的总线绑定v-model="option"：
<input type="radio" v-model="option" value="a" />
<input type="radio" v-model="option" value="b" />
<input type="radio" v-model="option" value="c" />
举个例子，让我们实现一组单选按钮，来选择T恤的颜色：
<script setup>
import { ref } from "vue"
const color = ref("white")
</script>
<template>
  <label><input type="radio" v-model="color" value="white" />White</label>
  <label><input type="radio" v-model="color" value="red" />Red</label>
  <label><input type="radio" v-model="color" value="blue" />Blue</label>
  <div>T-shirt color: {{ color }}</div>
</template>
初始情况下，White单选框会被选中，因为color的初始值为'white'。
点击其他任意T恤颜色，并根据选定的颜色改变color。
单选框的value属性是可绑定的：你可以使用:value。当选项列表来自一个数组时这很有帮助：
<script setup>
import { ref } from "vue"
const color = ref("white")
const COLORS = [
  { option: "white", label: "White" },
  { option: "black", label: "Black" },
  { option: "blue", label: "Blue" },
</script>
<template>
  <label v-for="{ option, label } in COLORS" :key="option">
    <input type="radio" v-model="color" :value="option" /> {{ label }}
  </label>
  <div>T-shirt color: {{ color }}</div>
</template>
v-model修饰符
除了在绑定表单输入方面做得很好之外，v-model还有一个额外的功能，叫做修饰符。
修饰符是应用于v-model的一段逻辑，用于自定义其行为。修饰符通过使用点语法v-model.<modifier>应用于v-model，例如v-mode.trim。
默认情况下，Vue提供了3个修饰符，trim、number和lazy。
清除一个字符串是指删除字符串开头和结尾的空白处。例如，清除应用于' Wow! '的结果是'Wow!'。
v-model.trim修饰符在赋值给绑定的ref之前清除输入表单的值：
<script setup>
import { ref } from 'vue'
const text = ref('')
</script>
<template>
  <input v-model.trim="text" type="text" />
  <pre>"{{ text }}"</pre>
</template>
number
v-model.number修饰符在输入表单的值上应用一个数字解析器。
如果用户引入了一个可以解析为数字的值，v-model.number="number"则将解析后的数字分配给number。在其他情况下，如果引入的值不是数字，number就会被分配为原始字符串。
<script setup>
import { ref } from "vue";
const number = ref("");
</script>
<template>
  <input v-model.number="number" type="text" />
  <div>{{ typeof number }}</div>
</template>
当你在input中引入'345'，那么number就会变成345（一个数字）。值解析会自动发生。
但是如果你在input中引入一个非数值，比如'abc'，那么number就会被分配为相同的值'abc'。
默认情况下，当绑定的值更新时，v-model会使用input事件。但如果使用修饰符v-model.lazy，你可以将该事件改为change事件。
input和change事件的主要区别是什么呢？
input是每当你在输入表单键入时就会触发。
change是只有当你把焦点从输入表单移开时，才会触发。在输入表单里输入并不会触发change事件。
下面示例使用了lazy绑定：
<script setup>
import { ref } from 'vue'
const text = ref('Unknown')
</script>
<template>
  <input v-model.lazy="text" type="input" />
  <div>{{ text }}</div>
</template>
如果你有一个许多输入字段和大量状态的表单，你可以应用lazy修饰符来禁用用户输入时的实时响应。这可以防止输入时页面卡住。
v-model将表单输入与ref或响应式对象进行绑定。
绑定是通过两个简单的步骤实现的：
首先，通过const text = ref('')创建ref 。
其次，将 ref 分配给 v-model 属性：<input v-model="text" type="text" />。
以上就是本文的全部内容，如果对你有所帮助，欢迎点赞、收藏、转发~