Vue表單控制元件繫結
基礎用法
可以用 v-model
指令在表單控制元件元素上建立雙向資料繫結。它會根據控制元件型別自動選取正確的方法來更新元素。v-model
本質上不過是語法糖,它負責監聽使用者的輸入事件以更新資料
[注意]v-model
會忽略所有表單元素的value
、checked
、selected
特性的初始值。因為它會選擇Vue例項資料來作為具體的值。應該通過JS元件的data
選項中宣告初始值
【type:text】
<div id="example"> <input v-model="message" placeholder="edit me"> <p>Message is: {{ message }}</p> </div>
<script> var example = new Vue({ el: '#example', data:{ message:'' } }) </script>
實際上v-model是:value和@input事件的語法糖
<div id="example"> <input :value="message" placeholder="edit me" @input="message=$event.target.value"> <p>Message is: {{ message }}</p> </div>
<script> var example = new Vue({ el: '#example', data:{ message:'' }, }) </script>
【textarea】
<div id="example"> <div> <span>Multiline message is:</span> <p style="white-space: pre-line">{{ message }}</p> </div> <textarea v-model="message" placeholder="add multiple lines"></textarea> </div>
<script> var example = new Vue({ el: '#example', data:{ message:'' } }) </script>
[注意]在文字區域插值( <textarea></textarea>
) 並不會生效,應用 v-model
來代替
【type:checkbox】
<div id="example"> <input type="checkbox" id="checkbox" v-model="checked"> <label for="checkbox">{{ checked }}</label> </div>
<script> var example = new Vue({ el: '#example', data:{ checked:false } }) </script>
<div id="example"> <div> <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> </div> <div> <span>Checked names: {{ checkedNames }}</span> </div> </div>
<script> var example = new Vue({ el: '#example', data:{ checkedNames:[] } }) </script>
【type:radio】
<div id="example"> <div> <input type="radio" id="one" value="One" v-model="picked"> <label for="one">One</label> </div> <div> <input type="radio" id="two" value="Two" v-model="picked"> <label for="two">Two</label> </div> <div>Picked: {{ picked }}</div> </div>
<script> var example = new Vue({ el: '#example', data:{ picked:'' } }) </script>
【select】
單選列表
<div id="example"> <select v-model="selected"> <option disabled value="">請選擇</option> <option>A</option> <option>B</option> <option>C</option> </select> <span>Selected: {{ selected }}</span> </div>
<script> var example = new Vue({ el: '#example', data:{ selected: '' } }) </script>
[注意]如果v-model
表達初始的值不匹配任何的選項,<select>
元素就會以”未選中”的狀態渲染。在iOS中,這會使使用者無法選擇第一個選項,因為這樣的情況下,iOS不會引發change事件。因此,像以上提供disabled選項是建議的做法
多選列表
<div id="example"> <select v-model="selected" multiple> <option>A</option> <option>B</option> <option>C</option> </select> <span>Selected: {{ selected }}</span> </div>
<script> var example = new Vue({ el: '#example', data:{ selected: [] } }) </script>
動態選項
用v-for渲染
<div id="example"> <select v-model="selected"> <option v-for="option in options" :value="option.value"> {{ option.text }} </option> </select> <span>Selected: {{ selected }}</span> </div>
<script> var example = new Vue({ el: '#example', data:{ selected: 'A', options: [ { text: 'One', value: 'A' }, { text: 'Two', value: 'B' }, { text: 'Three', value: 'C' } ] } }) </script>
繫結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
實現,並且這個屬性的值可以不是字串
【複選框】
<div id="example"> <input type="checkbox" v-model="toggle" :true-value="a" :false-value="b"> <span>{{ toggle }}</span> </div>
<script> var example = new Vue({ el: '#example', data:{ toggle:'', a:true, b:false } }) </script>
【單選按鈕】
<div id="example"> <input type="radio" v-model="pick" :value="a"> <span>{{ pick }}</span> </div>
<script> var example = new Vue({ el: '#example', data:{ pick:'', a:true } }) </script>
【選擇列表】
<div id="example"> <select v-model="selected"> <option :value="{ number: 123 }">123</option> <option :value="{ number: 234 }">234</option> <option :value="{ number: 345 }">345</option> </select> <span>Selected: {{ selected.number }}</span> </div>
<script> var example = new Vue({ el: '#example', data:{ selected:'' } }) </script>
修飾符
【.lazy】
在預設情況下, v-model
在input
事件中同步輸入框的值與資料,但可以新增一個修飾符 lazy
,從而轉變為在change
事件中同步
下列例子中,游標移出輸入框時,才同步資料
<div id="example"> <input v-model.lazy="message" placeholder="edit me"> <p>Message is: {{ message }}</p> </div>
<script> var example = new Vue({ el: '#example', data:{ message:'' } }) </script>
【.number】
如果想自動將使用者的輸入值轉為Number型別(如果原值的轉換結果為 NaN 則返回原值),可以新增一個修飾符number
給v-model
來處理輸入值
這通常很有用,因為在 type="number"
時 HTML 中輸入的值也總是會返回字串型別
<div id="example"> <div> <input v-model="age1" type="number"> <span>{{type1}}</span> <p>普通輸入: {{ age1 }}</p> </div> <div> <input v-model.number="age2" type="number"> <span>{{type2}}</span> <p>number修飾符輸入: {{ age2 }}</p> </div> </div>
<script> var example = new Vue({ el: '#example', data:{ age1:'', age2:'', }, computed:{ type1:function(){ return typeof(this.age1) }, type2:function(val){ return typeof(this.age2) }, } }) </script>
【.trim】
如果要自動過濾使用者輸入的首尾空格,可以新增 trim
修飾符到 v-model
上過濾輸入
<div id="example"> <input v-model.trim="msg"> <p>msg is: {{ msg }}</p> </div>
<script> var example = new Vue({ el: '#example', data:{ msg:'' } }) </script>