1、基礎語法
你可以用 v-model
指令在表單控件元素上創建雙向數據綁定。它會根據控件類型自動選取正確的方法來更新元素。盡管有些神奇,但 v-model
本質上不過是語法糖,它負責監聽用戶的輸入事件以更新數據,并特別處理一些極端的例子。
v-model
并不關心表單控件初始化所生成的值。因為它會選擇 Vue 實例數據來作為具體的值。
文本
<input v-model="message" placeholder="edit me"> <p>Message is: {{ message }}</p>
<div id="example-1" class="demo"> <input v-model="message" placeholder="edit me"> <p>Message is: {{ message }}</p> </div> <script> new Vue({ el: '#example-1', data: { message: '' } }) </script>
多行文本
span>Multiline message is:</span> <p style="white-space: pre">{{ message }}</p> <br> <textarea v-model="message" placeholder="add multiple lines"></textarea>
<div id="example-textarea" class="demo"> <span>Multiline message is:</span> <p style="white-space: pre">{{ message }}</p> <br> <textarea v-model="message" placeholder="add multiple lines"></textarea> </div> <script> new Vue({ el: '#example-textarea', data: { message: '' } }) </script>
注意:在文本區域插值( <textarea></textarea>
) 并不會生效,應用 v-model
來代替
復選框
單個勾選框,邏輯值:
<input type="checkbox" id="checkbox" v-model="checked"> <label for="checkbox">{{ checked }}</label>
<div id="example-2" class="demo"> <input type="checkbox" id="checkbox" v-model="checked"> <label for="checkbox">{{ checked }}</label> </div> <script> new Vue({ el: '#example-2', data: { checked: false } }) </script>
多個勾選框,綁定到同一個數組:
<div id="example-3" class="demo"> <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> <script> new Vue({ el: '#example-3', data: { checkedNames: [] } }) </script>

單選按鈕
<div id="example-4" class="demo"> <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> <script> new Vue({ el: '#example-4', data: { picked: '' } }) </script>
選擇列表
<div id="example-6" class="demo"> <select v-model="selected" multiple style="width: 50px"> <option>A</option> <option>B</option> <option>C</option> </select> <br> <span>Selected: {{ selected }}</span> </div> <script> new Vue({ el: '#example-6', data: { selected: [] } }) </script>

多選列表(綁定到一個數組):
<div id="example-6" class="demo"> <select v-model="selected" multiple style="width: 50px"> <option>A</option> <option>B</option> <option>C</option> </select> <br> <span>Selected: {{ selected }}</span> </div> <script> new Vue({ el: '#example-6', data: { selected: [] } }) </script>
動態選項,用 v-for
渲染:
<div id="example-7" class="demo"> <select v-model="selected"> <option v-for="option in options" v-bind:value="option.value"> {{ option.text }} </option> </select> <span>Selected: {{ selected }}</span> </div> <script> new Vue({ el: '#example-7', data: { selected: 'A', options: [ { text: 'One', value: 'A' }, { text: 'Two', value: 'B' }, { text: 'Three', value: 'C' } ] } }) </script>
2、綁定value
對于單選按鈕,勾選框及選擇列表選項, v-model
綁定的 value 通常是靜態字符串(對于勾選框是邏輯值):
<!-- 當選中時,`picked` 為字符串 "a" --> <input type="radio" v-model="picked" value="a"> <!-- `toggle` 為 true 或 false --> <input type="checkbox" v-model="toggle"> <!-- 當選中時,`selected` 為字符串 "abc" --> <select v-model="selected"> <option value="abc">ABC</option> </select>
但是有時我們想綁定 value 到 Vue 實例的一個動態屬性上,這時可以用 v-bind
實現,并且這個屬性的值可以不是字符串。
復選框
<input type="checkbox" v-model="toggle" v-bind:true-value="a" v-bind:false-value="b" >
// 當選中時 vm.toggle === vm.a // 當沒有選中時 vm.toggle === vm.b
單選按鈕
<input type="radio" v-model="pick" v-bind:value="a"> // 當選中時 vm.pick === vm.a
選列表設置
<select v-model="selected"> <!-- 內聯對象字面量 --> <option v-bind:value="{ number: 123 }">123</option> </select>
// 當選中時 typeof vm.selected // -> 'object' vm.selected.number // -> 123
3、修飾符
.lazy
在默認情況下, v-model
在 input
事件中同步輸入框的值與數據 (除了 上述 IME 部分),但你可以添加一個修飾符 lazy
,從而轉變為在 change
事件中同步:
<!-- 在 "change" 而不是 "input" 事件中更新 --> <input v-model.lazy="msg" >
.number
如果想自動將用戶的輸入值轉為 Number 類型(如果原值的轉換結果為 NaN 則返回原值),可以添加一個修飾符 number
給 v-model
來處理輸入值:
<input v-model.number="age" type="number">
這通常很有用,因為在 type="number"
時 HTML 中輸入的值也總是會返回字符串類型。
.trim
如果要自動過濾用戶輸入的首尾空格,可以添加 trim
修飾符到 v-model
上過濾輸入:
<input v-model.trim="msg">
4、v-model與組件
HTML 內建的 input 類型有時不能滿足你的需求。還好,Vue 的組件系統允許你創建一個具有自定義行為可復用的 input 類型,這些 input 類型甚至可以和 v-model
一起使用!要了解更多,請參閱自定義 input 類型
文章列表