Vue表單控制元件資料繫結方法詳解

阿新 • • 發佈：2020-02-06

基礎用法

可以用 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>

更多關於Vue表單控制元件資料繫結的方法請點選下面的相關連結