v-model · Vue從入門到實戰

## v-model指令 **類型：** 隨表單控件類型不同而不同。 **修飾符：** - .lazy - 取代 input 監聽 change 事件 - .number - 輸入字符串轉為數字 - .trim - 輸入首尾空格過濾 **用法：** v-model指令用來在input、select、text、checkbox、radio等表單控件或者組件上創建雙向綁定。你可以用 v-model 指令在表單控件元素上創建雙向數據綁定。它會根據控件類型自動選取正確的方法來更新元素。盡管有些神奇，但 v-model 本質上不過是語法糖，它負責監聽用戶的輸入事件以更新數據，并特別處理一些極端的例子。 >[danger] v-model 并不關心表單控件初始化所生成的值。因為它會選擇 Vue 實例數據來作為具體的值。對于要求 IME （如中文、日語、韓語等）的語言，你會發現那v-model不會在 ime 構成中得到更新。如果你也想實現更新，請使用 input事件。 ---- >[success]示例1 文本 ~~~ <div id="demo"> <input v-model="message" placeholder="edit me"> <p>Message is: {{ message }}</p> </div> <script type="text/javascript"> var app=new Vue({ el:'#demo', data:{ message:'it研習社' } }); </script> ~~~ >[success]預覽：https://ityanxi.github.io/Vue-tutorial/chapter04/10v-model1.html --- >[success]示例2 多行文本 ~~~ <div id="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 type="text/javascript"> var app=new Vue({ el:'#demo', data:{ message:'it研習社' } }); </script> ~~~ >[success]預覽：https://ityanxi.github.io/Vue-tutorial/chapter04/10v-model2.html --- >[danger] 在文本區域插值(` <textarea></textarea>` ) 并不會生效，應用 v-model 來代替 ---- >[success]示例3 復選框單個勾選框，邏輯值： ~~~ <div id="demo"> <input type="checkbox" id="checkbox" v-model="checked"> <label for="checkbox">{{ checked }}</label> </div> <script type="text/javascript"> var app=new Vue({ el:'#demo', data:{ checked:false } }); </script> ~~~ >[success]預覽：https://ityanxi.github.io/Vue-tutorial/chapter04/10v-model3.html ---- >[success]示例4 多個勾選框，綁定到同一個數組： ~~~ <div id="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 type="text/javascript"> var app=new Vue({ el:'#demo', data:{ checkedNames: [] } }); </script> ~~~ >[success]預覽：https://ityanxi.github.io/Vue-tutorial/chapter04/10v-model4.html >[success]示例5 單選按鈕 ~~~ <div id="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 type="text/javascript"> var app=new Vue({ el:'#demo', data:{ picked: '' } }); </script> ~~~ >[success]預覽：https://ityanxi.github.io/Vue-tutorial/chapter04/10v-model5.html ---- >[success]示例6 選擇列表 ~~~ <div id="demo"> <select v-model="selected"> <option>A</option> <option>B</option> <option>C</option> </select> <span>Selected: {{ selected }}</span> </div> <script type="text/javascript"> var app=new Vue({ el:'#demo', data:{ selected: null } }); </script> ~~~ >[success]預覽：https://ityanxi.github.io/Vue-tutorial/chapter04/10v-model6.html ---- >[success]示例7 多選列表（綁定到一個數組）： ~~~ <div id="demo"> <select v-model="selected" multiple> <option>A</option> <option>B</option> <option>C</option> </select> <span>Selected: {{ selected }}</span> </div> <script type="text/javascript"> var app=new Vue({ el:'#demo', data:{ selected: [] } }); </script> ~~~ >[success]預覽：https://ityanxi.github.io/Vue-tutorial/chapter04/10v-model7.html ---- >[success]示例8 動態選項，用v-for渲染 ~~~ <div id="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 type="text/javascript"> var app=new Vue({ el:'#demo', data:{ selected: 'A', options: [ { text: 'One', value: 'A' }, { text: 'Two', value: 'B' }, { text: 'Three', value: 'C' } ] } }); </script> ~~~ >[success]預覽：https://ityanxi.github.io/Vue-tutorial/chapter04/10v-model8.html ## 綁定value 對于單選按鈕，勾選框及選擇列表選項， v-model 綁定的 value 通常是靜態字符串（對于勾選框是邏輯值）： >[success]示例9 ~~~ <div id="demo">  <input type="radio" v-model="picked" value="a">  <input type="checkbox" v-model="toggle">  <select v-model="selected"> <option value="abc">ABC</option> </select> </div> <script type="text/javascript"> var app=new Vue({ el:'#demo', data:{ picked:'a', toggle:true, selected:true } }); </script> ~~~ >[success]預覽：https://ityanxi.github.io/Vue-tutorial/chapter04/10v-model9.html 但是有時我們想綁定 value 到 Vue 實例的一個動態屬性上，這時可以用 v-bind 實現，并且這個屬性的值可以不是字符串。 ~~~ <div id="demo">  <input type="radio" v-model="toggle" v-bind:true-value="a" v-bind:false-value="b">  <input type="checkbox" v-model="pick" v-bind:value="a">  <select v-model="selected"> <option value="abc">ABC</option> </select> </div> ~~~ >[success]預覽：https://ityanxi.github.io/Vue-tutorial/chapter04/10v-model10.html ## 修飾符在默認情況下， v-model 在 input 事件中同步輸入框的值與數據 (除了上述 IME 部分)，但你可以添加一個修飾符 lazy ，從而轉變為在 change 事件中同步： - .lazy ~~~  <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"> ~~~