1. 前言
本小節(jié)我們將介紹 Vue 中數(shù)據(jù)的雙向綁定指令 v-model
。v-model
的學習相對簡單。我們可以用 v-model
指令在表單 <input>
、<textarea>
及 <select>
元素上創(chuàng)建雙向數(shù)據(jù)綁定。它會根據(jù)控件類型自動選取正確的方法來更新元素。它負責監(jiān)聽用戶的輸入事件以更新數(shù)據(jù),并對一些極端場景進行一些特殊處理。
2. 慕課解釋
用 v-model 指令在表單
<input>
、<textarea>
及<select>
元素上創(chuàng)建雙向數(shù)據(jù)綁定。它會根據(jù)控件類型自動選取正確的方法來更新元素。v-model 本質(zhì)上不過是語法糖。它負責監(jiān)聽用戶的輸入事件以更新數(shù)據(jù),并對一些極端場景進行一些特殊處理?!?官方定義
v-model 是 vue 提供的用來對表單控件做數(shù)據(jù)雙向綁定的指令。它可以根據(jù)用戶的輸入動態(tài)改變其綁定的值,同樣可以根據(jù)綁定值的改變來操作頁面 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>
代碼解釋:
上述代碼,我們通過 v-model 給輸入框 input 和 name 形成雙向綁定,當 input 中數(shù)據(jù)發(fā)生改變時 name 也會發(fā)生改變。同理,我們在控制臺通過 vm.name = ""
給 name 賦值時輸入框的內(nèi)容也會發(fā)生改變。
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 中數(shù)據(jù)發(fā)生改變時 desc 也會發(fā)生改變。同理,我們在控制臺通過 vm.desc = ""
給 desc 賦值時輸入框的內(nèi)容也會發(fā)生改變。
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
改變選中狀態(tài)時 isDelivery
也會發(fā)生改變。同理,我們在控制臺通過 vm.isDelivery = true
給 isDelivery
賦值時 checkbox
的選中狀態(tài)也會發(fā)生改變。
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 改變選中狀態(tài)時 types 也會發(fā)生改變。同理,我們在控制臺通過 vm.types = []
給 types
賦值時對應(yīng) checkbox 的選中狀態(tài)也會發(fā)生改變。
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 改變選中狀態(tài)時 isFree 也會發(fā)生改變。同理,我們在控制臺通過 vm.isFree = 0
給 isFree 賦值時 radio 的選中狀態(tài)也會發(fā)生改變。
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 也會發(fā)生改變。同理,我們在控制臺通過 vm.company = 0
給 company 賦值時 select 的選中項也會發(fā)生改變。
4. 值綁定
對于單選按鈕、復選框及選擇框的選項,v-model 綁定的值通常是靜態(tài)字符串 (對于復選框也可以是布爾值):
<!-- 當選中時,`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 實例的一個動態(tài)屬性上,這時可以用 v-bind 實現(xiàn),并且這個屬性的值可以不是字符串。
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
代碼解釋:
上述代碼中,我們通過 v-bind:value 給 randio 指定選中的值,當 radio 選中時 vm.pick === vm.a
。
4.3 選擇框選項綁定值
<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 事件觸發(fā)后將輸入框的值與數(shù)據(jù)進行同步 (除了上述輸入法組合文字時)。你可以添加 lazy 修飾符,從而轉(zhuǎn)變?yōu)槭褂?change 事件進行同步:
<!-- 在“change”時而非“input”時更新 -->
<input v-model.lazy="msg" >
5.2 .number
如果想自動將用戶的輸入值轉(zhuǎn)為數(shù)值類型,可以給 v-model 添加 number 修飾符:
<input v-model.number="age" type="number">
5.3 .trim
如果要自動過濾用戶輸入的首尾空白字符,可以給 v-model 添加 trim 修飾符:
<input v-model.trim="msg">
6. 小結(jié)
本小節(jié)我們介紹了 Vue 數(shù)據(jù)雙向綁定 v-model 的使用,主要包括以下知識點:
- 使用 v-model 對 input、textarea、select 等表單項進行數(shù)據(jù)綁定;
- 使用 v-bind:value 給表單項的值進行綁定;
- v-model 修飾符的使用。