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>
その他の拡張