Vue.js 事件處理器

事件監聽可以使用 v-on 指令：

v-on

<div id="app"> <button v-on:click="counter += 1">增加 1</button> <p>這個按鈕被點選了 {{ counter }} 次。</p> </div> <script> new Vue({ el: '#app', data: { counter: 0 } }) </script>

嘗試一下 ?

通常情況下，我們需要使用一個方法來呼叫 JavaScript 方法。

v-on 可以接收一個定義的方法來呼叫。

v-on

<div id="app"> <!-- `greet` 是在下面定義的方法名 --> <button v-on:click="greet">Greet</button> </div> <script> var app = new Vue({ el: '#app', data: { name: 'Vue.js' }, // 在 `methods` 物件中定義方法 methods: { greet: function (event) { // `this` 在方法裡指當前 Vue 例項 alert('Hello ' + this.name + '!') // `event` 是原生 DOM 事件 if (event) { alert(event.target.tagName) } } } }) // 也可以用 JavaScript 直接呼叫方法 app.greet() // -> 'Hello Vue.js!' </script>

嘗試一下 ?

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

v-on

<div id="app"> <button v-on:click="say('hi')">Say hi</button> <button v-on:click="say('what')">Say what</button> </div> <script> new Vue({ el: '#app', methods: { say: function (message) { alert(message) } } }) </script>

嘗試一下 ?

事件修飾符

Vue.js 為 v-on 提供了事件修飾符來處理 DOM 事件細節，如：event.preventDefault() 或 event.stopPropagation()。

Vue.js 通過由點 . 表示的指令字尾來呼叫修飾符。

  • .stop - 阻止冒泡
  • .prevent - 阻止預設事件
  • .capture - 阻止捕獲
  • .self - 只監聽觸發該元素的事件
  • .once - 只觸發一次
  • .left - 左鍵事件
  • .right - 右鍵事件
  • .middle - 中間滾輪事件
<!-- 阻止單擊事件冒泡 -->
<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>

<!-- click 事件只能點選一次，2.1.4版本新增 -->
<a v-on:click.once="doThis"></a>

按鍵修飾符

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
  • .ctrl
  • .alt
  • .shift
  • .meta

例項

<p><!-- Alt + C -->
<input @keyup.alt.67="clear">
<!-- Ctrl + Click -->
<div @click.ctrl="doSomething">Do something</div>