Vue.2.0.5-事件處理器

監聽事件

可以用 v-on 指令監聽 DOM 事件來觸發一些 JavaScript 代碼。

示例：

<div id="example-1">
  <button v-on:click="counter += 1">增加 1</button>
  <p>這個按鈕被點擊了 {{ counter }} 次。</p>
</div>

var example1 = new Vue({
  el: '#example-1',
  data: {
    counter: 0
  }
})

結果：

增加 1

這個按鈕被點擊了 0 次。

方法事件處理器

許多事件處理的邏輯都很復雜，所以直接把 JavaScript 代碼寫在 v-on 指令中是不可行的。因此 v-on 可以接收一個定義的方法來調用。

示例：

<div id="example-2">
  <!-- `greet` 是在下面定義的方法名 -->
  <button v-on:click="greet">Greet</button>
</div>

var example2 = new Vue({
  el: '#example-2',
  data: {
    name: 'Vue.js'
  },
  // 在 `methods` 對象中定義方法
  methods: {
    greet: function (event) {
      // `this` 在方法里指當前 Vue 實例
      alert('Hello ' + this.name + '!')
      // `event` 是原生 DOM 事件
      alert(event.target.tagName)
    }
  }
})
// 也可以用 JavaScript 直接調用方法
example2.greet() // -> 'Hello Vue.js!'

結果：

Greet

內聯處理器方法

除了直接綁定到一個方法，也可以用內聯 JavaScript 語句：

<div id="example-3">
  <button v-on:click="say('hi')">Say hi</button>
  <button v-on:click="say('what')">Say what</button>
</div>

new Vue({
  el: '#example-3',
  methods: {
    say: function (message) {
      alert(message)
    }
  }
})

結果：

Say hi  Say what

有時也需要在內聯語句處理器中訪問原生 DOM 事件。可以用特殊變量 $event 把它傳入方法：

<button v-on:click="warn('Form cannot be submitted yet.', $event)">Submit</button>

// ...
methods: {
  warn: function (message, event) {
    // 現在我們可以訪問原生事件對象
    if (event) event.preventDefault()
    alert(message)
  }
}

事件修飾符

在事件處理程序中調用 event.preventDefault() 或 event.stopPropagation() 是非常常見的需求。盡管我們可以在 methods 中輕松實現這點，但更好的方式是：methods 只有純粹的數據邏輯，而不是去處理 DOM 事件細節。

為了解決這個問題， Vue.js 為 v-on 提供了 事件修飾符。通過由點(.)表示的指令后綴來調用修飾符。

• .stop
• .prevent
• .capture
• .self

  <!-- 阻止單擊事件冒泡 -->
  <a v-on:click.stop="doThis"></a>
  <!-- 提交事件不再重載頁面 -->
  <form v-on:submit.prevent="onSubmit"></form>
  <!-- 修飾符可以串聯  -->
  <a v-on:click.stop.prevent="doThat"></a>
  <!-- 只有修飾符 -->
  <form v-on:submit.prevent></form>
  <!-- 添加事件偵聽器時使用事件捕獲模式 -->
  <div v-on:click.capture="doThis">...</div>
  <!-- 只當事件在該元素本身（而不是子元素）觸發時觸發回調 -->
  <div v-on:click.self="doThat">...</div>

  按鍵修飾符

  在監聽鍵盤事件時，我們經常需要監測常見的鍵值。 Vue 允許為 v-on 在監聽鍵盤事件時添加按鍵修飾符：

  <!-- 只有在 keyCode 是 13 時調用 vm.submit() -->
  <input v-on:keyup.13="submit">

  記住所有的 keyCode 比較困難，所以 Vue 為最常用的按鍵提供了別名：

  <!-- 同上 -->
  <input v-on:keyup.enter="submit">
  <!-- 縮寫語法 -->
  <input @keyup.enter="submit">

  全部的按鍵別名：

  • enter
  • tab
  • delete (捕獲 “刪除” 和 “退格” 鍵)
  • esc
  • space
  • up
  • down
  • left
  • right

  可以通過全局 config.keyCodes 對象自定義按鍵修飾符別名：

  // 可以使用 v-on:keyup.f1
  Vue.config.keyCodes.f1 = 112

  為什么在 HTML 中監聽事件?

  你可能注意到這種事件監聽的方式違背了關注點分離（separation of concern）傳統理念。不必擔心，因為所有的 Vue.js 事件處理方法和表達式都嚴格綁定在當前視圖的 ViewModel 上，它不會導致任何維護上的困難。實際上，使用 v-on 有幾個好處：

  1. 掃一眼 HTML 模板便能輕松定位在 JavaScript 代碼里對應的方法。

  2. 因為你無須在 JavaScript 里手動綁定事件，你的 ViewModel 代碼可以是非常純粹的邏輯，和 DOM 完全解耦，更易於測試。

  3. 當一個 ViewModel 被銷毀時，所有的事件處理器都會自動被刪除。你無須擔心如何自己清理它們。

  ---

  原文：http://vuejs.org/guide/events.html