Vue.js v-on 指令详解:基础用法、事件修饰符与按键修饰符

作者:青山有信

时间:2026-10-23

浏览:577

本文详细介绍 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>

运行效果:

v-on 指令概述

@click 表达式既可以直接执行简单的 JS 语句,也可以调用 Vue 实例 methods 选项中定义的函数名。

HTML 代码示例:


<button @click="quickAdd(3)">快速增长</button>

JavaScript 代码示例:


methods: {
 quickAdd: function (i) {
  i = i || 1;//为避免参数为 null 或 undefined 值,这里设定了默认值 1
  this.count += i;
 }
}

运行效果:

v-on 指令概述

注意:当 @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 )

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章