7-事件 & 监听 & 修饰符

监听事件: v-on监听 DOM 事件在触发时运行JS代码

<div id="example-1">
  /* v-on 监听事件 */
  <button v-on:click="counter += 1">Add 1</button>
  <p>{{ counter }}</p>
</div>
var example1 = new Vue({
  el: '#example-1',
  data: {
    counter: 0
  }
})

事件处理方法: JS 代码写在 v-on 中是不可行的。可以接收调用的方法名定义在 methods: {} 中

<div id="example-2">
  <!-- `greet` 是在下面定义的方法名 -->
  <button v-on:click="greet">Greet</button>
</div>
var vm = new Vue({
  el: '#example-2',
  data: {
    name: 'Vue.js'
  },
  methods: {    /* 实例直接调用方法 vm.greet() */
    greet(event) {
      console.log( 'hello world' )
    }
  }
})

内联处理器中的方法: 除了直接绑定方法,也可以在内联 JS 中调用方法(常是传递参数)

<div id="example-3">
  /* 内联中调用方法 & 传递参数 */
  <button v-on:click="say('hi')">Say hi</button>
</div>
new Vue({
  el: '#example-3',
  methods: {
    say(message) {
      alert(message)
    }
  }
})

$event: 内联语句中访问原始 DOM 事件,把 $event 它传入方法(event永远在最末尾)

<button v-on:click="warn('num', $event )">Submit</button>
methods: {
  warn(message, event) {    /* 方法末尾传入 event 对象 */
    /* 访问原生事件对象 */
    if (event) event.preventDefault()
    alert(message)
  }
}

事件修饰符: Vue.js 为 v-on 提供了事件修饰符

.stop: 阻止事件冒泡

  <!-- 阻止单击事件继续传播 -->
  <a v-on:click.stop="doThis"></a>

.prevent: 阻止默认事件的发生

  <!-- 提交事件不再重载页面 -->
  <form v-on:submit.prevent="onSubmit"></form>

  <!-- 只有修饰符 -->
  <form v-on:submit.prevent></form>

.capture: 事件捕获

  <!-- 添加事件监听器时使用事件捕获模式 -->
  <div v-on:click.capture="doThis">...</div>

.self: 只有点击他本身时才去执行，点击他的子元素不去执行

  <!-- 只当在 event.target 是当前元素自身时触发处理函数 -->
  <!-- 即事件不是从内部元素触发的 -->
  <div v-on:click.self="doThat">...</div>

.once: 只会触发一次

  <!-- 点击事件将只会触发一次 -->
  <a v-on:click.once="doThis"></a>

.passive: 滚动事件的行为会立即被触发,不要把 .passive 和 .prevent 一起使用,.prevent 将会被忽略

  <!-- 滚动事件的默认行为 (即滚动行为) 将会立即触发 -->
  <!-- 而不会等待 `onScroll` 完成  -->
  <!-- 这其中包含 `event.preventDefault()` 的情况 -->
  <div v-on:scroll.passive="onScroll">...</div>

按键修饰符: v-on 可以在监听键盘事件时添加按键修饰符

.enter   .tab   .delete (捕获"删除"和"退格"键)
.esc     .space .up
.down    .left  .right

通过全局 config.keyCodes 对象自定义按键修饰符别名

Vue.config.keyCodes.f1 = 112

系统修饰键: 仅在按下相应按键时才触发鼠标或键盘事件的监听器

.ctrl   .alt   .shift   .meta

<!-- Alt + C -->
<input @keyup.alt.67="clear">

<!-- Ctrl + Click -->
<div @click.ctrl="doSomething">Do something</div>

.exact修饰符: 精确的系统修饰符组合触发的事件

<!-- 即使 Alt 或 Shift 被一同按下时也会触发 -->
<button @click.ctrl="onClick">A</button>

<!-- 有且只有 Ctrl 被按下的时候才触发 -->
<button @click.ctrl.exact="onCtrlClick">A</button>

<!-- 没有任何系统修饰符被按下的时候才触发 -->
<button @click.exact="onClick">A</button>

鼠标按钮修饰符: 仅响应特定的鼠标按钮

.left   .right   .middle

为什么在 HTML 中监听事件?

· Vue.js 事件处理方法和表达式都严格绑定在当前视图的 ViewModel 上，它不会导致任何维护上的困难
· 能轻松定位在 JS 代码里对应的方法
· 无须在 JS里手动绑定事件, ViewModel 代码可以是非常纯粹的逻辑,和 DOM 完全解耦,更易于测试
· 当一个 ViewModel 被销毁时，所有的事件处理器都会自动被删除。你无须担心如何清理它们