v-on

  • 缩写：@

  • 预期：Function | Inline Statement | Object

  • 参数：event

  • 修饰符：

    • .stop - 调用 event.stopPropagation()。
    • .prevent - 调用 event.preventDefault()。
    • .capture - 添加事件侦听器时使用 capture 模式。
    • .self - 只当事件是从侦听器绑定的元素本身触发时才触发回调。
    • .{keyCode | keyAlias} - 只当事件是从特定键触发时才触发回调。
    • .native - 监听组件根元素的原生事件。
    • .once - 只触发一次回调。
    • .left - (2.2.0) 只当点击鼠标左键时触发。
    • .right - (2.2.0) 只当点击鼠标右键时触发。
    • .middle - (2.2.0) 只当点击鼠标中键时触发。
    • .passive - (2.3.0) 以 { passive: true } 模式添加侦听器
  • 用法：

绑定事件监听器。事件类型由参数指定。表达式可以是一个方法的名字或一个内联语句，如果没有修饰符也可以省略。

用在普通元素上时，只能监听原生 DOM 事件。用在自定义元素组件上时，也可以监听子组件触发的自定义事件。

在监听原生 DOM 事件时，方法以事件为唯一的参数。如果使用内联语句，语句可以访问一个 $event 属性：v-on:click="handle('ok', $event)"。

从 2.4.0 开始，v-on 同样支持不带参数绑定一个事件/监听器键值对的对象。注意当使用对象语法时，是不支持任何修饰器的。

  • 示例：
  1. <!-- 方法处理器 -->
  2. <button v-on:click="doThis"></button>
  4. <!-- 动态事件 (2.6.0+) -->
  5. <button v-on:[event]="doThis"></button>
  7. <!-- 内联语句 -->
  8. <button v-on:click="doThat('hello', $event)"></button>
  10. <!-- 缩写 -->
  11. <button @click="doThis"></button>
  13. <!-- 动态事件缩写 (2.6.0+) -->
  14. <button @[event]="doThis"></button>
  16. <!-- 停止冒泡 -->
  17. <button @click.stop="doThis"></button>
  19. <!-- 阻止默认行为 -->
  20. <button @click.prevent="doThis"></button>
  22. <!-- 阻止默认行为，没有表达式 -->
  23. <form @submit.prevent></form>
  25. <!--  串联修饰符 -->
  26. <button @click.stop.prevent="doThis"></button>
  28. <!-- 键修饰符，键别名 -->
  29. <input @keyup.enter="onEnter">
  31. <!-- 键修饰符，键代码 -->
  32. <input @keyup.13="onEnter">
  34. <!-- 点击回调只会触发一次 -->
  35. <button v-on:click.once="doThis"></button>
  37. <!-- 对象语法 (2.4.0+) -->
  38. <button v-on="{ mousedown: doThis, mouseup: doThat }"></button>

在子组件上监听自定义事件 (当子组件触发“my-event”时将调用事件处理器)：

  1. <my-component @my-event="handleThis"></my-component>
  3. <!-- 内联语句 -->
  4. <my-component @my-event="handleThis(123, $event)"></my-component>
  6. <!-- 组件中的原生事件 -->
  7. <my-component @click.native="onClick"></my-component>