一、监听事件
可以用v-on指令监听DOM事件,并在触发时运行一些JavaScript代码。
<div id="example-1">
<button v-on:click="counter += 1">ADD 1</button>
<p>The button above has been clicked {{ counter }} times</p>
</div>
var example1 = new Vue({
el:'#example-1',
data: {
counter: 0
}
})
二、事件处理方法
许多事情处理逻辑会更复杂,所以直接把JavaScript代码写在v-on中是不可行的。因此v-on还可以接收一个需要调用的方法名称。
<div id="example-2">
<button v-on:click="greet">Greet</button>
</div>
var example-2 = new Vue({
el: "#example-2"
data: {
name: "Vue.js"
},
//在methods对象中定义方法
methods: {
greet: function (event) {
alert('Hello ' + this.name + '!')
//event是原生的DOM事件
if(event) {
alert(event.target.tagName)
}
}
}
})
//也可以用JavaScript直接调用方法
example2.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)
}
}
})
如果需要在内联语句处理器中访问原始的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()是非常常见的需求,尽管我们可以在方法中轻松实现这一点,但是方法最好只有纯粹的数据逻辑,而不是去处理DOM事件的细节。
为了解决这个问题,Vue.js为v-on提供了事件修饰符,修饰符是由"."开头的指令后缀来表示的。
- .stop
- .prevent
- .capture
- .self
- .once
- .passive
<!--阻止单击事件继续传播 -->
<a v-on:click.stop="doThis"></a>
<!-- 提交事件不再重载页面 -->
<form v-on:submit.prevent="doThat"></form>
<!-- 修饰符可以串联 -->
<a v-on:click.stop.prevent="doThat"></a>
<!-- 只有修饰符-->
<form v-on:submit.prevent></form>
<!-- 添加事件监听器时使用事件捕获模式 -->
<!-- 即元素自身触发的事件先在此处理,然后才交由内部元素进行处理 -->
<div v-on:click.capture="doThis">...</div>
<!-- 只当在 event.target 是当前元素自身时触发处理函数 -->
<!-- 即事件不是从内部元素触发的 -->
<div v-on:click.self="doThat">...</div>
修饰符的顺序很重要,相应的代码以同样的顺序产生,因此,用v-on:click.prevent.self会阻止所有的点击,而v-on:click.self.prevent只会阻止对元素自身的点击。
另外在vue的后续版本中,又新增了其他的修饰符:
2.1.4新增
<!--点击事件只能触发一次 -->
<a v-on:click.once="doThis"></a>
2.3.0新增
对应addEventListener中的passive选项提供了.passive修饰符。
<!--
滚动事件的默认行为将会立即触发
不会等待onScroll完成
这其中包含event.preventDefault()的情况
-->
<div v-on:scroll.passive="onScroll">...</div>
这个.passive修饰符尤其能够提升移动端的性能
五、按键修饰符
Vue允许为v-on在监听键盘事件时添加按键修饰符
<!- 只有在'key'是'Enter'时调动'vm.submit()' -->
<input v-on:keyup.enter="submit">
你可以直接将keyboardEvent.key暴露的任意有效按键名转换为kebad-case来作为修饰符
<input v-on:keyup.page-down="onPageDown">
在上述示例中,处理函数只会在$event.key等于PageDown时被调用。
5.1 按键码
keyCode事件用法已经被废弃并可能不会被新的浏览器支持
使用keyCode特性也是允许的:
<input v-on:keyup.13="submit">
为了在必要的情况下支持旧浏览器,Vue提供了绝大多数常用的按键码的别名:
- enter
- .tab
- .delete
- .esc
- .space
- .up
- .down
- .left
- .right
还可以通过全局config.keyCodes对象自定义按键修饰符别名:
//可以使用'v-on:keyup.f1'
Vue.config.keyCodes.f1 = 112
六、系统修饰键
可以用如下修饰符来实现仅在按下相应按键时才触发鼠标或键盘事件的监听器。
- .ctrl
- .alt
- .shift
- .meta
例如:
<!-- Alt + C -->
<input @keyup.alt.67="clear">
<!-- Ctrl + Click -->
<div @click.ctrl="doSomething">Do something</div>
修饰键与常规按键不同,在和keyup事件一起使用时,事件触发时修饰键必须处于按下状态,也就是说在上面的实例中,只有在按住ctrl的情况下释放其他按键才可以触发keyup.ctrl。单单的释放Ctrl也不会触发事件。如果想实现单单按住Ctrl也可以触发事件,可换用keyCode : keyup.17。
.exact修饰符
.extract修饰符允许控制精确的系统修饰符组合触发的事件
<!-- 即使 Alt 或 Shift 被一同按下时也会触发 -->
<button @click.ctrl="onClick">A</button>
<!-- 有且只有 Ctrl 被按下的时候才触发 -->
<button @click.ctrl.exact="onCtrlClick">A</button>
<!-- 没有任何系统修饰符被按下的时候才触发 -->
<button @click.exact="onClick">A</button>
鼠标按钮修饰符
- .left
- .right
- .middle
这些修饰符会限制处理函数仅响应特定的鼠标按钮。