1. 前言
本小节我们将介绍 Vue 中数据的双向绑定指令 v-model
。v-model
的学习相对简单。我们可以用 v-model
指令在表单 <input>
、<textarea>
及 <select>
元素上创建双向数据绑定。它会根据控件类型自动选取正确的方法来更新元素。它负责监听用户的输入事件以更新数据,并对一些极端场景进行一些特殊处理。
2. 解释
用 v-model 指令在表单
<input>
、<textarea>
及<select>
元素上创建双向数据绑定。它会根据控件类型自动选取正确的方法来更新元素。v-model 本质上不过是语法糖。它负责监听用户的输入事件以更新数据,并对一些极端场景进行一些特殊处理。— 官方定义
3. 基本用法
接下来我们将详细介绍 v-model 在不同表单元素上的使用。
3.1 单行文本 input
<!DOCTYPE html>
<html lang="en">
<head>
<Meta charset="UTF-8">
<Meta name="viewport" content="width=device-width, initial-scale=1.0">
<Meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>Document</title>
</head>
<body>
<div id="app">
<input v-model="name" placeholder="请输入商品名称"/>
<p>名称是: {{ name }}</p>
</div>
</body>
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script>
var vm = new Vue({
el: '#app',
data: {
name: ''
},
})
</script>
</html>
代码解释:
上述代码,我们通过 v-model 给输入框 input 和 name 形成双向绑定,当 input 中数据发生改变时 name 也会发生改变。同理,我们在控制台通过 vm.name = ""
给 name 赋值时输入框的内容也会发生改变。
3.2 多行文本 textarea
<!DOCTYPE html>
<html lang="en">
<head>
<Meta charset="UTF-8">
<Meta name="viewport" content="width=device-width, initial-scale=1.0">
<Meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>Document</title>
</head>
<body>
<div id="app">
<textarea v-model="desc" placeholder="请输入商品描述"></textarea>
<p>描述是: {{ desc }}</p>
</div>
</body>
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script>
var vm = new Vue({
el: '#app',
data: {
desc: ''
},
})
</script>
</html>
代码解释:
上述代码,我们通过 v-model 给输入框 textarea 和 desc 形成双向绑定,当 textarea 中数据发生改变时 desc 也会发生改变。同理,我们在控制台通过 vm.desc = ""
给 desc 赋值时输入框的内容也会发生改变。
3.3 单个复选框
<!DOCTYPE html>
<html lang="en">
<head>
<Meta charset="UTF-8">
<Meta name="viewport" content="width=device-width, initial-scale=1.0">
<Meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>Document</title>
</head>
<body>
<div id="app">
<div>
<input type="checkBox" id="delivery" v-model="isDelivery">
<label for="delivery">{{ isDelivery }}</label>
<span>选项: {{ isDelivery }}</span>
</div>
</div>
</body>
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script>
var vm = new Vue({
el: '#app',
data: {
isDelivery: false
},
})
</script>
</html>
代码解释:
上述代码,我们通过 v-model
给单个选择框 checkBox
和 isDelivery
形成双向绑定,当 checkBox
改变选中状态时 isDelivery
也会发生改变。同理,我们在控制台通过 vm.isDelivery = true
给 isDelivery
赋值时 checkBox
的选中状态也会发生改变。
3.4 多个复选框
<!DOCTYPE html>
<html lang="en">
<head>
<Meta charset="UTF-8">
<Meta name="viewport" content="width=device-width, initial-scale=1.0">
<Meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>Document</title>
</head>
<body>
<div id="app">
<div>
<input type="checkBox" id="food" value="食品" v-model="types">
<label for="food">食品</label>
<input type="checkBox" id="book" value="图书" v-model="types">
<label for="book">图书</label>
<input type="checkBox" id="clothes" value="衣服" v-model="types">
<label for="clothes">衣服</label>
<br>
<span>类型: {{ types }}</span>
</div>
</div>
</body>
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script>
var vm = new Vue({
el: '#app',
data: {
types: []
},
})
</script>
</html>
代码解释:
上述代码,我们通过 v-model 给多个选择框 checkBox
和 types
形成双向绑定,当任意 checkBox 改变选中状态时 types 也会发生改变。同理,我们在控制台通过 vm.types = []
给 types
赋值时对应 checkBox 的选中状态也会发生改变。
3.5 单选按钮
<!DOCTYPE html>
<html lang="en">
<head>
<Meta charset="UTF-8">
<Meta name="viewport" content="width=device-width, initial-scale=1.0">
<Meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>Document</title>
</head>
<body>
<div id="app">
<div>
<input type="radio" id="yes" value="1" v-model="isFree">
<label for="one">是</label>
<input type="radio" id="no" value="0" v-model="isFree">
<label for="no">否</label>
<br>
<span>选择: {{ isFree }}</span>
</div>
</div>
</body>
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script>
var vm = new Vue({
el: '#app',
data: {
isFree: ''
},
})
</script>
</html>
代码解释:
上述代码,我们通过 v-model 给单选按钮 radio 和 isFree 形成双向绑定,当 radio 改变选中状态时 isFree 也会发生改变。同理,我们在控制台通过 vm.isFree = 0
给 isFree 赋值时 radio 的选中状态也会发生改变。
3.6 下拉选择框
<!DOCTYPE html>
<html lang="en">
<head>
<Meta charset="UTF-8">
<Meta name="viewport" content="width=device-width, initial-scale=1.0">
<Meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>Document</title>
</head>
<body>
<div id="app">
<div>
<select v-model="company">
<option value="">请选择</option>
<option>顺丰</option>
<option>中通</option>
<option>圆通</option>
</select>
<span>选项: {{ company }}</span>
</div>
</div>
</body>
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script>
var vm = new Vue({
el: '#app',
data: {
company: ''
},
})
</script>
</html>
代码解释:
上述代码,我们通过 v-model 给选择框 select 和 company 形成双向绑定,当 select 改变选项时 company 也会发生改变。同理,我们在控制台通过 vm.company = 0
给 company 赋值时 select 的选中项也会发生改变。
4. 值绑定
对于单选按钮、复选框及选择框的选项,v-model 绑定的值通常是静态字符串 (对于复选框也可以是布尔值):
<!-- 当选中时,`picked` 为字符串 "abc" -->
<input type="radio" v-model="picked" value="abc">
<!-- `toggle` 为 true 或 false -->
<input type="checkBox" v-model="toggle">
<!-- 当选中第一个选项时,`selected` 为字符串 "001" -->
<select v-model="selected">
<option value="001">顺丰</option>
<option value="002">圆通</option>
</select>
4.1 复选框绑定值
<input type="checkBox" id="delivery" v-model="isDelivery" true-value="yes" false-value="no">
代码解释:
上述代码中,我们通过 true-value 和 false-value 给 复选框指定来选中和非选中的值,当选中时 vm.isDelivery === 'yes'
,当没有选中时 vm.isDelivery === 'no'
4.2 单选按钮绑定值
<input type="radio" v-model="pick" v-bind:value="a">
// 当选中时
vm.pick === vm.a
4.3 选择框选项绑定值
<select v-model="selected">
<option v-bind:value="{ number: 123 }">123</option>
</select>
5. 修饰符
5.1 .lazy
<!-- 在“change”时而非“input”时更新 -->
<input v-model.lazy="msg" >
5.2 .number
<input v-model.number="age" type="number">
5.3 .trim
<input v-model.trim="msg">
6. 小结
本小节我们介绍了 Vue 数据双向绑定 v-model 的使用,主要包括以下知识点:
- 使用 v-model 对 input、textarea、select 等表单项进行数据绑定;
- 使用 v-bind:value 给表单项的值进行绑定;
- v-model 修饰符的使用。