表单输入绑定

基础用法

---

v-model指令可以在表单、</code>、<code><select></code>元素上创建双向数据绑定。<br> 它会根据控件类型自动选取正确的方法来更新元素。但<code>v-model</code>本质上不过是语法糖。它负责监听用户的输入时间以及更新数据，并对一些极端场景进行一些特殊处理。</p> <blockquote> <p><code>v-model</code>会忽略所有表单元素的<code>value</code>、<code>checked</code> 、<code>selected</code>属性的初始值而总是将Vue示例的数据作为数据源。应该通过js在组件的<code>data</code>选项中声明初始值。</p> </blockquote> <p><code>v-model</code>在内部为不同的输入元素使用不同的属性并抛出不同的事件：</p> <ul> <li>text 和 textarea元素使用<code>value</code>属性和<code>input</code>事件；</li> <li>checkbox 和radio使用<code>checked</code>属性和<code>change</code>事件；</li> <li>select字段将<code>value</code>作为prop并将<code>change</code>作为事件。</li> </ul> <blockquote> <p>对于需要使用输入法的语言，你会发现<code>v-model</code>不会再输入法组合文字过程中得到更新。如果你也想处理这个过程，请使用<code>input</code>事件。</p> </blockquote> <h4>文本</h4> <pre><code><input v-model="message" placeholder="edit me"> <p>Message is: {{ message }}</p> </code></pre> <h4>多行文本</h4> <pre><code><span>Multiline message is:</span> <p style="white-space: pre-line;">{{ message }}</p> <br> <textarea v-model="message" placeholder="add multiple lines">

在文本区域插值（{{text}}）并不会生效，应用v-model来代替。

复选框

单个复选框，绑定到布尔值：

{{ checked }}

多个复选框，绑定到同一个数组：

Jack

John

Mike


Checked names: {{ checkedNames }}

new Vue({
  el: '...',
  data: {
    checkedNames: []
  }
})

单选按钮

  
  One
  

  
  Two
  

  Picked: {{ picked }}


new Vue({
  el: '#example-4',
  data: {
    picked: ''
  }
})

选择框

单选时：

  
    请选择
    A
    B
    C
  
  Selected: {{ selected }}

new Vue({
  el: '...',
  data: {
    selected: ''
  }
})

如果v-model表达式的初始值未能匹配任何选项，元素将被渲染为“未选中”状态。在ios中，这回使用户无法选择第一个选项。因为这这样情况下，ios不会触发change事件。因此，更推荐像上面这样提供一个值为空的禁用选项。

多选时（绑定到一个数组）：

A B C
Selected: {{ selected }}

new Vue({ el: '#example-6', data: { selected: [] } })

用v-for渲染的动态选项：

  
    {{ option.text }}
  

Selected: {{ selected }}

new Vue({
  el: '...',
  data: {
    selected: 'A',
    options: [
      { text: 'One', value: 'A' },
      { text: 'Two', value: 'B' },
      { text: 'Three', value: 'C' }
    ]
  }
})

值绑定

---

对于单选按钮，复选框及选择框的选项，v-model绑定的值通常是静态字符串（对于复选框也可以是布尔值）：

  ABC

但是有时我们可能想把值绑定到vue市里的一个动态属性上，这是可以用v-bind实现，并且这个属性的值乐意不是字符串。

复选框

// 当选中时
vm.toggle === 'yes'
// 当没有选中时
vm.toggle === 'no'

这里的true-value和false-value属性并不会影响输入控件的value属性，因为浏览器在提交表单时并不会包含未被选中的复选框。如果要确保表单中这两个值中的一个能够被提交，请换用单选按钮。

单选按钮

// 当选中时
vm.pick === vm.a

选择框的选项

    
  123


// 当选中时
typeof vm.selected // => 'object'
vm.selected.number // => 123

 

修饰符

---

在默认情况下，v-model在每次input 事件触发后将输入框的值与数据进行同步（除了上述输入法组合文字时）。你可以添加lazy修饰符，从而转为在change事件上之后进行同步：

如果想自动将用户的输入值转为数值类型，可以给v-model添加number修饰符：

这通常很有用，因为即使在type='number'时，HTML输入元素的值也总会返回字符串。如果这个值无法被parseFloat()解析，则会返回原始值。

如果要自动过滤用户输入的首位空白字符，可以给v-model添加trim修饰符：