在 Vue 中控制表单输入
Vue中v-model的思路很简单。定义一个可响应式的text（通常是一个ref），然后用v-model="text"将这个值绑定到一个input上。这就创造了一个双向的数据流：
- 用户在输入框中输入，
text会发生变化。 text发生变化，输入框的值也随之变化。
让我们看看如何在Vue 3中使用v-model来控制表单输入。
绑定表单输入
让我们实现一个组件，渲染一个初始值为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。
trim
清除一个字符串是指删除字符串开头和结尾的空白处。例如，清除应用于' 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'。
lazy
默认情况下，当绑定的值更新时，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" />。
以上就是本文的全部内容，如果对你有所帮助，欢迎点赞、收藏、转发~
