点此查看 所有教程、项目、源码导航
文章目录
-
- [1. 本篇说明](#1. 本篇说明)
- [2. v-on 基础写法](#2. v-on 基础写法)
- [3. 事件传参](#3. 事件传参)
-
- [特殊:同时传参 + 拿到原生事件对象 event](#特殊:同时传参 + 拿到原生事件对象 event)
- [4. 事件修饰符(重点)](#4. 事件修饰符(重点))
-
- [4.1 .prevent 阻止默认行为](#4.1 .prevent 阻止默认行为)
- [4.2 .stop 阻止事件冒泡](#4.2 .stop 阻止事件冒泡)
- [4.3 .once 事件只触发一次](#4.3 .once 事件只触发一次)
- [4.4 .self 只有自身触发才执行](#4.4 .self 只有自身触发才执行)
- [5. 按键修饰符(键盘事件)](#5. 按键修饰符(键盘事件))
- [6. 小结](#6. 小结)
1. 本篇说明
前面我们学习了文本渲染、属性绑定,这一节学习事件绑定指令 v-on。
用来给元素绑定点击、输入、鼠标移入等原生DOM事件,v-on: 可以简写为 @。
提前说明:本篇需要用到 Vue3 的响应式API
ref。本节先简单体验效果,ref 的完整用法、原理、坑点,放到下一篇单独详细讲解。
2. v-on 基础写法
html
<template>
<p>计数器:{{ num }}</p>
<!-- 完整写法 v-on:click -->
<button v-on:click="add">+1</button>
<!-- 简写 @click,日常开发推荐简写 -->
<button @click="sub">-1</button>
</template>
<script setup>
// 先引入ref,这里先体验,不用深究
import { ref } from 'vue'
// 创建响应式变量
const num = ref(0)
const add = () => {
// script内部修改,需要 .value
num.value++
}
const sub = () => {
num.value--
}
</script>
代码讲解:
v-on:click:绑定点击事件;@click是简写,二者等价。- 引号里面写函数名,不加括号,点击时自动执行函数。
- ✅ 效果:点击按钮,页面数字自动更新。
- 👉 暂时记住两点:
ref用来创建响应式数据;- script里修改要加
.value,模板里直接写变量名。
另外,简单行内表达式:逻辑非常简单,也可以直接写表达式,如下:
html
<button @click="num++">直接+1</button>
⚠️ 易错提醒:
在 template 模板中 ,ref 会自动解包,直接写
num++,不要写 num.value++ ,写了不会生效。在 script setup 里面 ,修改才需要
.value:num.value++
3. 事件传参
调用函数的时候,可以给方法传递参数。
html
<template>
<button @click="sayHi('张三')">向张三打招呼</button>
<button @click="sayHi('李四')">向李四打招呼</button>
</template>
<script setup>
const sayHi = (name) => {
alert(`你好,${name}`)
}
</script>
效果:

特殊:同时传参 + 拿到原生事件对象 $event
如果既需要自定义参数,又要拿到原生event对象,Vue提供内置变量 $event
html
<template>
<!-- eslint-disable vue/no-multiple-template-root -->
<button @click="handleClick('测试消息', $event)">点击获取事件对象</button>
</template>
<script setup>
const handleClick = (msg, e) => {
// e 就是原生 MouseEvent 对象,可以拿到点击坐标、目标元素等
console.log(msg, e)
}
</script>
效果:

注意:不写括号的时候,默认第一个参数就是event;加括号传自定义参数,想要event就要手动传
$event。
4. 事件修饰符(重点)
事件修饰符以 . 开头,写在事件后面,用来简化原生JS里的阻止冒泡、阻止默认行为等操作,不用在函数里手写 e.preventDefault()、e.stopPropagation()。
4.1 .prevent 阻止默认行为
最常用:阻止a标签跳转、表单默认提交
html
<template>
<a href="https://www.baidu.com" @click.prevent="linkClick">点我,不会跳转百度</a>
</template>
<script setup>
const linkClick = () => {
alert('链接默认跳转行为被阻止了')
}
</script>
4.2 .stop 阻止事件冒泡
html
<template>
<div @click="divClick" style="padding:20px;background:#eee;">
外层盒子(点这里触发div事件)
<button @click.stop="btnClick">按钮(加了stop,不会触发外层)</button>
</div>
</template>
<script setup>
const divClick = () => {
console.log('外层div被点击了')
alert('div点击')
}
const btnClick = () => {
console.log('按钮被点击了')
alert('按钮点击')
}
</script>
不加 .stop 时,点击按钮会同时触发按钮和外层div的事件;加上之后只会触发按钮事件。
4.3 .once 事件只触发一次
html
<template>
<button @click.once="onlyOnce">只能点一次</button>
</template>
<script setup>
const onlyOnce = () => {
alert('这个弹窗只会弹出一次,再点无效')
}
</script>
4.4 .self 只有自身触发才执行
只有点击元素本身才触发,冒泡上来的事件不触发
html
<template>
<div @click.self="selfClick" style="padding:20px;background:#eee;">
外层盒子
<button>点我不会触发div</button>
</div>
</template>
<script setup>
const selfClick = () => {
alert('只有直接点击盒子本身才会触发')
}
</script>
5. 按键修饰符(键盘事件)
绑定键盘输入事件,监听指定按键
html
<template>
<input @keyup.enter="enterSubmit" placeholder="输入内容,回车提交">
</template>
<script setup>
const enterSubmit = () => {
alert('检测到回车,触发提交!')
}
</script>
常用:.enter、.tab、.delete、.esc、.space、.up、.down、.left、.right
6. 小结
v-on简写@,用来绑定各类DOM事件(click、keyup等)- 不加括号:自动传入event;加括号传参,需要event就要手动传
$event - 事件修饰符:
.prevent阻止默认行为、.stop阻止冒泡、.once只执行一次 - 按键修饰符,用来监听键盘指定按键
- 本节课我们简单体验了
ref,借助它实现点击修改数据、页面自动更新;ref完整原理、使用规则、易错点,下一篇详细讲解