副队长Vue3教程(5)--事件绑定 v-on

点此查看 所有教程、项目、源码导航

文章目录

    • [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 是简写,二者等价。
  • 引号里面写函数名,不加括号,点击时自动执行函数。
  • ✅ 效果:点击按钮,页面数字自动更新。
  • 👉 暂时记住两点:
    1. ref 用来创建响应式数据;
    2. 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. 小结

  1. v-on 简写 @,用来绑定各类DOM事件(click、keyup等)
  2. 不加括号:自动传入event;加括号传参,需要event就要手动传 $event
  3. 事件修饰符:.prevent 阻止默认行为、.stop 阻止冒泡、.once 只执行一次
  4. 按键修饰符,用来监听键盘指定按键
  5. 本节课我们简单体验了 ref,借助它实现点击修改数据、页面自动更新;ref完整原理、使用规则、易错点,下一篇详细讲解
相关推荐
艾莉丝努力练剑11 分钟前
【AI大模型接入SDK】C++的SessionManager 线程安全
java·开发语言·前端·c++·人工智能·学习·安全
泯泷1 小时前
Vercel AI SDK 6 完整教程系列 - 第二部分:结构化数据与工具调用
前端·javascript
OpenTiny社区2 小时前
我用Vue 100%复制DeepSeek开源的网页App,代码更少,功能还更多!
前端·vue.js·github
MyBili2 小时前
Chrome开发者工具入门:从看懂页面到高效调试
前端·chrome·谷歌浏览器·开发工具·chrome devtools·网页调式·网络请求分析
云起SAAS2 小时前
手机靓号选号商城H5源码 完整前后台可直接运行
前端·javascript·后端
程序员大阳3 小时前
副队长Vue3教程(6)--script setup语法糖与ref基础响应式
vue.js·vue3·ref·script setup·基础响应式
code2cat3 小时前
JavaScript编程篇之异步请求:切换到待办,为什么又显示了全部任务
前端·javascript
Moment3 小时前
RSI 是怎样让 AI 改进自己的 ❓❓❓
前端·后端·面试
1-1=03 小时前
Vue 条件渲染和列表渲染
前端·javascript·vue.js