基礎(chǔ)用法
你可以用 v-model 指令在表單<input>彤钟、<textarea>及 <select>元素上創(chuàng)建雙向數(shù)據(jù)綁定胳搞。它會(huì)根據(jù)控件類型自動(dòng)選取正確的方法來更新元素会前。盡管有些神奇拨黔，但 v-model本質(zhì)上不過是語法糖蛔溃。它負(fù)責(zé)監(jiān)聽用戶的輸入事件以更新數(shù)據(jù)，并對(duì)一些極端場(chǎng)景進(jìn)行一些特殊處理篱蝇。
v-model 會(huì)忽略所有表單元素的 value贺待、checked、selected特性的初始值而總是將 Vue 實(shí)例的數(shù)據(jù)作為數(shù)據(jù)來源零截。你應(yīng)該通過 JavaScript 在組件的 data 選項(xiàng)中聲明初始值麸塞。也就是說在有data中的值為初始值的情況下，原先標(biāo)簽上的內(nèi)容忽視涧衙。
對(duì)于需要使用輸入法 (如中文哪工、日文、韓文等) 的語言弧哎，你會(huì)發(fā)現(xiàn) v-model 不會(huì)在輸入法組合文字過程中得到更新雁比。如果你也想處理這個(gè)過程，請(qǐng)使用 input 事件撤嫩。
文本
<input v-model="message" placeholder="edit me">
<p>Message is: {{ message }}</p>
此時(shí) input 中的內(nèi)容和 message中的是互相雙向綁定的偎捎。
多行文本
使用方法一致
<span>Multiline message is:</span>
<p style="white-space: pre-line;">{{ message }}</p>
<br>
<textarea v-model="message" placeholder="add multiple lines"></textarea>
在文本區(qū)域插值 (<textarea></textarea>) 并不會(huì)生效，應(yīng)用 v-model 來代替序攘。
復(fù)選框
//單個(gè)復(fù)選框
<input type="checkbox" id="checkbox" v-model="checked">
<label for="checkbox">{{ checked }}</label>
//多個(gè)復(fù)選框
<div id='example-3'>
<input type="checkbox" id="jack" value="Jack" v-model="checkedNames">
<label for="jack">Jack</label>
<input type="checkbox" id="john" value="John" v-model="checkedNames">
<label for="john">John</label>
<input type="checkbox" id="mike" value="Mike" v-model="checkedNames">
<label for="mike">Mike</label>
<br>
<span>Checked names: {{ checkedNames }}</span>
</div>
new Vue({
el: '#example-3',
data: {
checkedNames: []
}
})
單選按鈕
<div id="example-4">
<input type="radio" id="one" value="One" v-model="picked">
<label for="one">One</label>
<br>
<input type="radio" id="two" value="Two" v-model="picked">
<label for="two">Two</label>
<br>
<span>Picked: {{ picked }}</span>
</div>
new Vue({
el: '#example-4',
data: {
picked: ''
}
})
選擇框
<div id="example-5">
<select v-model="selected">
<option disabled value="">請(qǐng)選擇</option>
<option>A</option>
<option>B</option>
<option>C</option>
</select>
<span>Selected: {{ selected }}</span>
</div>
new Vue({
el: '...',
data: {
selected: ''
}
})
當(dāng)select中為空的時(shí)候茴她，下拉框?yàn)檎?qǐng)選擇，可以給他添加option中的文本程奠，充當(dāng)默認(rèn)值丈牢。
果 v-model 表達(dá)式的初始值未能匹配任何選項(xiàng)，<select>元素將被渲染為“未選中”狀態(tài)梦染。在 iOS 中赡麦，這會(huì)使用戶無法選擇第一個(gè)選項(xiàng)朴皆。因?yàn)檫@樣的情況下帕识，iOS 不會(huì)觸發(fā)change 事件泛粹。因此，更推薦像上面這樣提供一個(gè)值為空的禁用選項(xiàng)肮疗。
如果下拉框進(jìn)行多選晶姊，則吧select的值在data中綁定到一個(gè)空數(shù)組即可
new Vue({
el: '#example-6',
data: {
selected: []
}
})
值綁定
復(fù)選框
<input
type="checkbox"
v-model="toggle"
true-value="yes"
false-value="no"
>
result:{{toggle}}
這里綁定的屬性值，則是使用 yes 替換原本的true伪货。
這里的 true-value 和 false-value 特性并不會(huì)影響輸入控件的 value 特性们衙，因?yàn)闉g覽器在提交表單時(shí)并不會(huì)包含未被選中的復(fù)選框。如果要確保表單中這兩個(gè)值中的一個(gè)能夠被提交碱呼，(比如“yes”或“no”)蒙挑，請(qǐng)換用單選按鈕。
單選按鈕
<input type="radio" v-model="pick" v-bind:value="a">
// 當(dāng)選中時(shí)
vm.pick === vm.a
######### 選擇框的選項(xiàng)
<select v-model="selected">
<!-- 內(nèi)聯(lián)對(duì)象字面量 -->
<option v-bind:value="{ number: 123 }">123</option>
</select>
// 當(dāng)選中時(shí)
typeof vm.selected // => 'object'
vm.selected.number // => 123
修飾符
.lazy (將輸入框的響應(yīng)轉(zhuǎn)變?yōu)?change事件)
在默認(rèn)情況下愚臀，v-model 在每次 input 事件觸發(fā)后將輸入框的值與數(shù)據(jù)進(jìn)行同步 (除了上述輸入法組合文字時(shí))忆蚀。你可以添加 lazy 修飾符，從而轉(zhuǎn)變?yōu)槭褂?change 事件進(jìn)行同步：
<!-- 在“change”時(shí)而非“input”時(shí)更新 -->
也就是失去焦點(diǎn)時(shí)
<input v-model.lazy="msg" >
.number（將用戶的輸入值轉(zhuǎn)為數(shù)值類型）
如果想自動(dòng)將用戶的輸入值轉(zhuǎn)化為數(shù)字類型姑裂，可以給v-model添加.number的修飾符
<input v-model.number="age" type="number">
這樣的修飾符馋袜，會(huì)在用戶輸入 非數(shù)字的情況下禁止用戶輸入。
這通常很有用舶斧，因?yàn)榧词乖?type="number" 時(shí)欣鳖，HTML 輸入元素的值也總會(huì)返回字符串。
.trim(自動(dòng)過濾用戶輸入的首尾空白字符)
如果要自動(dòng)過濾用戶輸入的首尾空白字符茴厉，可以給 v-model 添加 trim 修飾符：
<input v-model.trim="msg">
在組件上使用 v-model
HTML 原生的輸入元素類型并不總能滿足需求泽台。幸好，Vue 的組件系統(tǒng)允許你創(chuàng)建具有完全自定義行為且可復(fù)用的輸入組件矾缓。這些輸入組件甚至可以和 v-model 一起使用师痕！要了解更多，請(qǐng)參閱組件指南中的自定義輸入組件而账。
