事件處理器 · vue2中文文檔

# 事件處理器 [](https://vuefe.cn/guide/events.html#監聽事件) ## [](https://vuefe.cn/guide/events.html#監聽事件)[](https://vuefe.cn/guide/events.html#監聽事件 "監聽事件")監聽事件可以用?`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 次。 [](https://vuefe.cn/guide/events.html#方法事件處理器) ## [](https://vuefe.cn/guide/events.html#方法事件處理器)[](https://vuefe.cn/guide/events.html#方法事件處理器 "方法事件處理器")方法事件處理器許多事件處理的邏輯都很復雜，所以直接把 JavaScript 代碼寫在?`v-on`?指令中是不可行的。因此?`v-on`?可以接收一個定義的方法來調用。示例： ~~~ <div id="example-2">  <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 [](https://vuefe.cn/guide/events.html#內聯處理器方法) ## [](https://vuefe.cn/guide/events.html#內聯處理器方法)[](https://vuefe.cn/guide/events.html#內聯處理器方法 "內聯處理器方法")內聯處理器方法除了直接綁定到一個方法，也可以用內聯 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) }} ~~~ [](https://vuefe.cn/guide/events.html#事件修飾符) ## [](https://vuefe.cn/guide/events.html#事件修飾符)[](https://vuefe.cn/guide/events.html#事件修飾符 "事件修飾符")事件修飾符在事件處理程序中調用?`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> ~~~ [](https://vuefe.cn/guide/events.html#按鍵修飾符) ## [](https://vuefe.cn/guide/events.html#按鍵修飾符)[](https://vuefe.cn/guide/events.html#按鍵修飾符 "按鍵修飾符")按鍵修飾符在監聽鍵盤事件時，我們經常需要監測常見的鍵值。 Vue 允許為?`v-on`?在監聽鍵盤事件時添加按鍵修飾符： ~~~ <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`?對象[自定義按鍵修飾符別名](https://vuefe.cn/api/#keyCodes)： ~~~ // 可以使用 v-on:keyup.f1Vue.config.keyCodes.f1 = 112 ~~~ [](https://vuefe.cn/guide/events.html#為什么在-HTML-中監聽事件) ## [](https://vuefe.cn/guide/events.html#為什么在-HTML-中監聽事件)[](https://vuefe.cn/guide/events.html#為什么在-HTML-中監聽事件 "為什么在 HTML 中監聽事件?")為什么在 HTML 中監聽事件? 你可能注意到這種事件監聽的方式違背了關注點分離（separation of concern）傳統理念。不必擔心，因為所有的 Vue.js 事件處理方法和表達式都嚴格綁定在當前視圖的 ViewModel 上，它不會導致任何維護上的困難。實際上，使用?`v-on`?有幾個好處： 1. 掃一眼 HTML 模板便能輕松定位在 JavaScript 代碼里對應的方法。 2. 因為你無須在 JavaScript 里手動綁定事件，你的 ViewModel 代碼可以是非常純粹的邏輯，和 DOM 完全解耦，更易于測試。 3. 當一個 ViewModel 被銷毀時，所有的事件處理器都會自動被刪除。你無須擔心如何自己清理它們。