在 Vue.js 中,我們用 v-on 指令來綁定並監聽 DOM 事件。綁定的內容可以是當前實例上的方法(後面不加括號),也可以是一個內聯表達式。本文從基本用法一路談到按鍵過濾器,並解釋為什麼把監聽器寫在 HTML 中反而是合理的設計。
基本用法
若綁定的是方法,原生的 DOM event 會作為第一個參數傳入,且這個 event 會帶有 targetVM 屬性,指向觸發事件的 ViewModel:
<div id="demo"> <a v-on="click: onClick">觸發一個方法函數</a> <a v-on="click: n++">觸發一個表達式</a> </div>
new Vue({ el: '#demo', data: { n: 0 }, methods: { onClick: function (e) { console.log(e.targetVM.n); console.log(e.target.tagName);// "A" console.log(e.targetVM === this);// true } } });
執行表達式
在 v-repeat 中使用 v-on 時,targetVM 特別有用,因為 v-repeat 會建立大量子 ViewModel。不過透過執行表達式,把代表當前 ViewModel 資料的別名傳進去,會更直觀:
<ul id="list"> <li v-repeat="item in items" v-on="click: toggle(item)"> {{item.text}} </li> <button v-on="click: submit('hello!', $event)">Submit</button> </ul>
new Vue({ el: '#list', data: { items: [ { text: 'one', done: true }, { text: 'two', done: false } ] }, methods: { toggle: function (item) { console.info(item.done); item.done = !item.done; console.info(item.done); }, submit: function (msg, e) { e.stopPropagation(); console.info(msg + ' submit is called!'); } } })
想在表達式中存取原本的 DOM event,可以傳入 $event 參數。
key 過濾器
監聽鍵盤事件時,我們常需要判斷常用的 key code。Vue.js 提供了一個只能用於 v-on 的特殊過濾器 key,它接收代表 key code 的參數並完成判斷:
<!-- 只有當 keyCode 等於 13 時才調用方法 --> <input v-on="keyup:mySubmit | key 13">
系統也提供了不少預設別名可直接使用:
<!-- 效果同上 --> <input v-on="keyup:submit | key 'enter'">
預設值為:enter、tab、delete、esc、up、down、left、right、space。
為什麼把監聽器寫在 HTML 中
乍看之下,把事件監聽寫在 HTML 裡似乎違背了「關注點分離」的傳統理念,但其實不必擔心。因為所有 Vue.js 事件處理方法與表達式都嚴格綁定在當前視圖的 ViewModel 上,不會造成維護困難。這樣做反而帶來幾個好處:
它便於在 HTML 模板中輕鬆定位到 JS 裡對應的方法實作。
因為無須在 JS 中手動綁定事件,ViewModel 的程式碼得以保持純粹的邏輯,與 DOM 完全解耦,也更易於測試。
當 ViewModel 被銷毀時,所有事件監聽都會自動移除,你不必費心自行清理。