Vue.js 表单输入绑定
基礎用法
你可以用?v-model?指令在表單?<input>、<textarea>?及?<select>?元素上創建雙向數據綁定。它會根據控件類型自動選取正確的方法來更新元素。盡管有些神奇,但?v-model?本質上不過是語法糖。它負責監聽用戶的輸入事件以更新數據,并對一些極端場景進行一些特殊處理。
v-model?會忽略所有表單元素的?value、checked、selected?特性的初始值而總是將 Vue 實例的數據作為數據來源。你應該通過 JavaScript 在組件的?data?選項中聲明初始值。
對于需要使用輸入法?(如中文、日文、韓文等) 的語言,你會發現?v-model?不會在輸入法組合文字過程中得到更新。如果你也想處理這個過程,請使用?input?事件。
文本
| <input v-model="message" placeholder="edit me"> <p>Message is: {{ message }}</p> |
?
Message is:
多行文本
| <span>Multiline message is:</span> <p style="white-space: pre-line;">{{ message }}</p> <br> <textarea v-model="message" placeholder="add multiple lines"></textarea> |
Multiline message is:
?
?
在文本區域插值 (<textarea></textarea>) 并不會生效,應用?v-model?來代替。
復選框
單個復選框,綁定到布爾值:
| <input type="checkbox" id="checkbox" v-model="checked"> <label for="checkbox">{{ checked }}</label> |
?false
多個復選框,綁定到同一個數組:
| <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: []} }) |
?Jack??John??Mike?
Checked names: []
單選按鈕
| <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: ''} }) |
?One?
?Two?
Picked:
選擇框
單選時:
| <div id="example-5"><select v-model="selected"><option disabled value="">請選擇</option><option>A</option><option>B</option><option>C</option></select><span>Selected: {{ selected }}</span> </div> |
| new Vue({el: '...',data: {selected: ''} }) |
請選擇?A?B?C?Selected:
如果?v-model?表達式的初始值未能匹配任何選項,<select>?元素將被渲染為“未選中”狀態。在 iOS 中,這會使用戶無法選擇第一個選項。因為這樣的情況下,iOS 不會觸發 change 事件。因此,更推薦像上面這樣提供一個值為空的禁用選項。
多選時 (綁定到一個數組):
| <div id="example-6"><select v-model="selected" multiple style="width: 50px;"><option>A</option><option>B</option><option>C</option></select><br><span>Selected: {{ selected }}</span> </div> |
| new Vue({el: '#example-6',data: {selected: []} }) |
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
值綁定
對于單選按鈕,復選框及選擇框的選項,v-model?綁定的值通常是靜態字符串 (對于復選框也可以是布爾值):
| <!-- 當選中時,`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> |
但是有時我們可能想把值綁定到 Vue 實例的一個動態屬性上,這時可以用?v-bind?實現,并且這個屬性的值可以不是字符串。
復選框
| <inputtype="checkbox"v-model="toggle"true-value="yes"false-value="no" > |
| // 當選中時 vm.toggle === 'yes' // 當沒有選中時 vm.toggle === 'no' |
這里的?true-value?和?false-value?特性并不會影響輸入控件的?value?特性,因為瀏覽器在提交表單時并不會包含未被選中的復選框。如果要確保表單中這兩個值中的一個能夠被提交,(比如“yes”或“no”),請換用單選按鈕。
單選按鈕
| <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 |
修飾符
.lazy
在默認情況下,v-model?在每次?input?事件觸發后將輸入框的值與數據進行同步 (除了上述輸入法組合文字時)。你可以添加?lazy?修飾符,從而轉變為使用?change事件進行同步:
| <!-- 在“change”時而非“input”時更新 --> <input v-model.lazy="msg" > |
.number
如果想自動將用戶的輸入值轉為數值類型,可以給?v-model?添加?number?修飾符:
| <input v-model.number="age" type="number"> |
這通常很有用,因為即使在?type="number"?時,HTML 輸入元素的值也總會返回字符串。如果這個值無法被?parseFloat()?解析,則會返回原始的值。
.trim
如果要自動過濾用戶輸入的首尾空白字符,可以給?v-model?添加?trim?修飾符:
| <input v-model.trim="msg"> |
在組件上使用?v-model
如果你還不熟悉 Vue 的組件,可以暫且跳過這里。
HTML 原生的輸入元素類型并不總能滿足需求。幸好,Vue 的組件系統允許你創建具有完全自定義行為且可復用的輸入組件。這些輸入組件甚至可以和?v-model?一起使用!要了解更多,請參閱組件指南中的自定義輸入組件。
from:?https://cn.vuejs.org/v2/guide/forms.html?
總結
以上是生活随笔為你收集整理的Vue.js 表单输入绑定的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Vue.js 事件处理
- 下一篇: Vue.js 组件基础