1. 前言
本小节我们将介绍 Vue 中数据的双向绑定指令 v-model
。v-model
的学习相对简单。我们可以用 v-model
指令在表单 <input>
、<textarea>
及 <select>
元素上创建双向数据绑定。它会根据控件类型自动选取正确的方法来更新元素。它负责监听用户的输入事件以更新数据,并对一些极端场景进行一些特殊处理。非常使用的一个功能。
2. 官方解释
用 v-model 指令在表单
<input>
、<textarea>
及<select>
元素上创建双向数据绑定。它会根据控件类型自动选取正确的方法来更新元素。v-model 本质上不过是语法糖。它负责监听用户的输入事件以更新数据,并对一些极端场景进行一些特殊处理。— 官方定义
v-model 是 vue 提供的用来对表单控件做数据双向绑定的指令。它可以根据用户的输入动态改变其绑定的值,同样可以根据绑定值的改变来操作页面 DOM 的更新。
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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!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><!-- 当选中时,`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><!-- 当选中时,`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>
但是有时我们可能想把值绑定到 Vue 实例的一个动态属性上,这时可以用 v-bind 实现,并且这个属性的值可以不是字符串。
4.1 复选框绑定值
<input type="checkbox" id="delivery" v-model="isDelivery" true-value="yes" false-value="no"><input type="checkbox" id="delivery" v-model="isDelivery" true-value="yes" false-value="no"><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<input type="radio" v-model="pick" v-bind:value="a"> // 当选中时 vm.pick === vm.a<input type="radio" v-model="pick" v-bind:value="a"> // 当选中时 vm.pick === vm.a
代码解释:
上述代码中,我们通过 v-bind:value 给 randio 指定选中的值,当 radio 选中时 vm.pick === vm.a
。
4.3 选择框选项绑定值
<select v-model="selected"><option v-bind:value="{ number: 123 }">123</option></select><select v-model="selected"> <option v-bind:value="{ number: 123 }">123</option> </select><select v-model="selected"> <option v-bind:value="{ number: 123 }">123</option> </select>
代码解释:
上述代码中,我们通过 v-bind:value
给 option 指定 value 值,当 该 option 选中时 vm.selected 的值为 { number: 123 }
。
5. 修饰符
5.1 .lazy
在默认情况下,v-model 在每次 input 事件触发后将输入框的值与数据进行同步 (除了上述输入法组合文字时)。你可以添加 lazy 修饰符,从而转变为使用 change 事件进行同步:
<!-- 在“change”时而非“input”时更新 --><input v-model.lazy="msg" ><!-- 在“change”时而非“input”时更新 --> <input v-model.lazy="msg" ><!-- 在“change”时而非“input”时更新 --> <input v-model.lazy="msg" >
5.2 .number
如果想自动将用户的输入值转为数值类型,可以给 v-model 添加 number 修饰符:
<input v-model.number="age" type="number"><input v-model.number="age" type="number"><input v-model.number="age" type="number">
5.3 .trim
如果要自动过滤用户输入的首尾空白字符,可以给 v-model 添加 trim 修饰符:
<input v-model.trim="msg"><input v-model.trim="msg"><input v-model.trim="msg">
暂无评论内容