表單控件綁定 · vue2中文文檔

# 表單控件綁定 [](https://vuefe.cn/guide/forms.html#基礎用法) ## [](https://vuefe.cn/guide/forms.html#基礎用法)[](https://vuefe.cn/guide/forms.html#基礎用法 "基礎用法")基礎用法你可以用?`v-model`?指令在表單控件元素上創建雙向數據綁定。它會根據控件類型自動選取正確的方法來更新元素。盡管有些神奇，但?`v-model`?本質上不過是語法糖，它負責監聽用戶的輸入事件以更新數據，并特別處理一些極端的例子。 > `v-model`?并不關心表單控件初始化所生成的值。因為它會選擇 Vue 實例數據來作為具體的值。 [](https://vuefe.cn/guide/forms.html#文本) ### [](https://vuefe.cn/guide/forms.html#文本)[](https://vuefe.cn/guide/forms.html#文本 "文本")文本 ~~~ <input v-model="message" placeholder="edit me"><p>Message is: {{ message }}</p> ~~~ Message is: [](https://vuefe.cn/guide/forms.html#多行文本) ### [](https://vuefe.cn/guide/forms.html#多行文本)[](https://vuefe.cn/guide/forms.html#多行文本 "多行文本")多行文本 ~~~ <span>Multiline message is:</span><p style="white-space: pre">{{ message }}</p><br><textarea v-model="message" placeholder="add multiple lines"></textarea> ~~~ Multiline message is: 在文本區域插值(?`<textarea></textarea>`?) 并不會生效，應用?`v-model`?來代替 [](https://vuefe.cn/guide/forms.html#復選框) ### [](https://vuefe.cn/guide/forms.html#復選框)[](https://vuefe.cn/guide/forms.html#復選框 "復選框")復選框單個勾選框，邏輯值： ~~~ <input type="checkbox" id="checkbox" v-model="checked"><label for="checkbox">{{ checked }}</label> ~~~ ?false 多個勾選框，綁定到同一個數組： ~~~ <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> ~~~ ~~~ new Vue({ el: '...', data: { checkedNames: [] }}) ~~~ ?Jack??John??Mike? Checked names: [] [](https://vuefe.cn/guide/forms.html#單選按鈕) ### [](https://vuefe.cn/guide/forms.html#單選按鈕)[](https://vuefe.cn/guide/forms.html#單選按鈕 "單選按鈕")單選按鈕 ~~~ <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> ~~~ ?One? ?Two? Picked: [](https://vuefe.cn/guide/forms.html#選擇列表) ### [](https://vuefe.cn/guide/forms.html#選擇列表)[](https://vuefe.cn/guide/forms.html#選擇列表 "選擇列表")選擇列表單選列表: ~~~ <select v-model="selected"> <option>A</option> <option>B</option> <option>C</option></select><span>Selected: {{ selected }}</span> ~~~ A?B?C?Selected: 多選列表（綁定到一個數組）： ~~~ <select v-model="selected" multiple> <option>A</option> <option>B</option> <option>C</option></select><br><span>Selected: {{ selected }}</span> ~~~ A?B?C? Selected: [] 動態選項，用?`v-for`?渲染： ~~~ <select v-model="selected"> <option v-for="option in options" v-bind:value="option.value"> {{ option.text }} </option></select><span>Selected: {{ selected }}</span> ~~~ ~~~ new Vue({ el: '...', data: { selected: 'A', options: [ { text: 'One', value: 'A' }, { text: 'Two', value: 'B' }, { text: 'Three', value: 'C' } ] }}) ~~~ ?? ?? ?One? ? ??? ?? ?Two? ? ??? ?? ?Three? ? ??Selected: A [](https://vuefe.cn/guide/forms.html#綁定-value) ## [](https://vuefe.cn/guide/forms.html#綁定-value)[](https://vuefe.cn/guide/forms.html#綁定-value "綁定 value")綁定 value 對于單選按鈕，勾選框及選擇列表選項，?`v-model`?綁定的 value 通常是靜態字符串（對于勾選框是邏輯值）： ~~~ <input type="radio" v-model="picked" value="a"><input type="checkbox" v-model="toggle"><select v-model="selected"> <option value="abc">ABC</option></select> ~~~ 但是有時我們想綁定 value 到 Vue 實例的一個動態屬性上，這時可以用?`v-bind`?實現，并且這個屬性的值可以不是字符串。 [](https://vuefe.cn/guide/forms.html#復選框-1) ### [](https://vuefe.cn/guide/forms.html#復選框-1)[](https://vuefe.cn/guide/forms.html#復選框-1 "復選框")復選框 ~~~ <input type="checkbox" v-model="toggle" v-bind:true-value="a" v-bind:false-value="b"> ~~~ ~~~ // 當選中時vm.toggle === vm.a// 當沒有選中時vm.toggle === vm.b ~~~ [](https://vuefe.cn/guide/forms.html#單選按鈕-1) ### [](https://vuefe.cn/guide/forms.html#單選按鈕-1)[](https://vuefe.cn/guide/forms.html#單選按鈕-1 "單選按鈕")單選按鈕 ~~~ <input type="radio" v-model="pick" v-bind:value="a"> ~~~ ~~~ // 當選中時vm.pick === vm.a ~~~ [](https://vuefe.cn/guide/forms.html#選擇列表設置) ### [](https://vuefe.cn/guide/forms.html#選擇列表設置)[](https://vuefe.cn/guide/forms.html#選擇列表設置 "選擇列表設置")選擇列表設置 ~~~ <select v-model="selected">  <option v-bind:value="{ number: 123 }">123</option></select> ~~~ ~~~ // 當選中時typeof vm.selected // -> 'object'vm.selected.number // -> 123 ~~~ [](https://vuefe.cn/guide/forms.html#修飾符) ## [](https://vuefe.cn/guide/forms.html#修飾符)[](https://vuefe.cn/guide/forms.html#修飾符 "修飾符")修飾符 [](https://vuefe.cn/guide/forms.html#lazy) ### [](https://vuefe.cn/guide/forms.html#lazy)[](https://vuefe.cn/guide/forms.html#lazy ".lazy")`.lazy` 在默認情況下，?`v-model`?在?`input`?事件中同步輸入框的值與數據，但你可以添加一個修飾符?`lazy`?，從而轉變為在?`change`?事件中同步： ~~~ <input v-model.lazy="msg" > ~~~ [](https://vuefe.cn/guide/forms.html#number) ### [](https://vuefe.cn/guide/forms.html#number)[](https://vuefe.cn/guide/forms.html#number ".number")`.number` 如果想自動將用戶的輸入值轉為 Number 類型（如果原值的轉換結果為 NaN 則返回原值），可以添加一個修飾符?`number`給?`v-model`?來處理輸入值： ~~~ <input v-model.number="age" type="number"> ~~~ 這通常很有用，因為在?`type="number"`?時 HTML 中輸入的值也總是會返回字符串類型。 [](https://vuefe.cn/guide/forms.html#trim) ### [](https://vuefe.cn/guide/forms.html#trim)[](https://vuefe.cn/guide/forms.html#trim ".trim")`.trim` 如果要自動過濾用戶輸入的首尾空格，可以添加?`trim`?修飾符到?`v-model`?上過濾輸入： ~~~ <input v-model.trim="msg"> ~~~