本文详细介绍 Vue.js 中 v-on 指令的使用方法,涵盖基础事件绑定、DOM 事件访问、事件修饰符(如 .stop、.prevent)及按键修饰符(如 .enter、.ctrl)的配置与组合技巧,帮助开发者高效处理用户交互。
v-on 指令概述
v-on 指令在 Vue.js 中主要用于绑定 DOM 事件监听。
v-on 基础用法
1 基础用法
通过 v-on 指令绑定事件后,Vue 会自动监听并响应相应的事件触发。
HTML 代码示例:
<div id="app">
<h3>已点击 {{count}} 次</h3>
<button @click="count++">点我</button>
</div>
注意:@click 是 v-on:click 的简写形式,其中 @ 符号即表示 v-on: 指令。
JavaScript 代码示例:
<script>
var app = new Vue({
el: '#app',
data: {
count:0
}
});
</script>
运行效果:

@click 表达式既可以直接执行简单的 JS 语句,也可以调用 Vue 实例 methods 选项中定义的函数名。
HTML 代码示例:
<button @click="quickAdd(3)">快速增长</button>
JavaScript 代码示例:
methods: {
quickAdd: function (i) {
i = i || 1;//为避免参数为 null 或 undefined 值,这里设定了默认值 1
this.count += i;
}
}
运行效果:

注意:当 @click 调用的方法不需要参数时,可以省略方法名后的括号。
使用 Vue.js 的一个优势在于:当 ViewModel 被销毁时,所有绑定在其上的事件处理器会自动被清理。
访问原生 DOM 事件
2 调用 DOM 事件
Vue.js 提供了 $event 变量,允许开发者访问原生 DOM 事件。该 $event 变量可以作为参数传递给事件处理方法。
HTML 代码示例:
<div id="app2">
<a href="www.163.com" rel="external nofollow" @click="openUrl('被禁用咯',$event)">被禁用咯</a>
</div>
JavaScript 代码示例:
var app2 = new Vue({
el: '#app2',
data: {
count: 0
},
methods: {
openUrl: function (param, event) {
event.preventDefault();
console.log("param:" + param);
}
}
});
控制台输出结果:
param:被禁用咯
此示例通过传入的 event 参数,调用了 preventDefault 方法,从而禁用了原有的链接跳转逻辑。
事件修饰符使用指南
3 事件修饰符
Vue.js 支持以下常用事件修饰符:
| 事件修饰符 | 示例 | 示例说明 |
|---|---|---|
| .stop | @click.stop | 阻止单击事件冒泡。 |
| .prevent | @submit.prevent | 提交页面不再重载页面。 |
| .capture | @click.capture | 添加事件监听器时使用事件捕获模式。 |
| .self | @click.self | 只有当单击事件是元素的自身事件时,才会触发。 |
| .once | @click.once | 只触发一次。 |
按键修饰符与组合键
4 按键修饰符
可以使用按键修饰符来监听表单元素上的特定键盘事件。
HTML 代码示例:
<div id="app3">
<input @keyup.13="enterClick">
</div>
JavaScript 代码示例:
var app3 = new Vue({
el: '#app3',
data: {},
methods: {
enterClick: function () {
console.log("enterClick");
}
}
});
输出结果:enterClick
该示例演示了如何通过回车按键修饰符来绑定并触发事件函数。
除了使用 keycode 指定按键外,还可以使用以下按键别名:
- .enter
- .tab
- .delete
- .esc
- .space
- .up
- .down
- .left
- .right
此外,还可以将按键修饰符与鼠标修饰符组合使用:
- .ctrl
- .alt
- .shift
- .meta:在 Mac 系统中对应 Command 键,在 Windows 系统中对应窗口键。
HTML 代码示例:
<div id="app4">
<input @keyup.alt.83="save">
</div>
JavaScript 代码示例:
var app4 = new Vue({
el: '#app4',
data: {},
methods: {
save: function () {
console.log("save");
}
}
});
输出结果:save
此示例通过组合按键修饰符,为输入框绑定了 alt + S 的组合键事件。
本文示例( DEMO )
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。