@click 是 v-on:click 的简写,用于绑定点击事件,支持绑定方法名、内联表达式、传参(含 $event)及 prevent/stop/once 等修饰符,适用于任意 HTML 元素。

Vue 模板中用 @click 就能快速绑定按钮点击操作,这是 v-on:click 的标准简写,功能完全一致,但更简洁直观。
基础写法:直接绑定方法名或内联语句
在按钮等可交互元素上添加 @click,后面接函数名(不加括号)或简单表达式:
-
绑定已定义的方法:
—— 推荐用于含逻辑的场景 -
执行简单操作(如修改数据):
—— 适合计数、开关切换等轻量操作
传参方式:支持自定义参数 + 原生事件对象
需要传值又想访问点击事件细节时,用 $event 显式占位:
- 对应方法中可同时接收字符串和原生 Event 对象:
function handleUser(name, e) { console.log(name, e.target); }
常见修饰符:简化阻止默认/冒泡等操作
不用在方法里手动调 e.preventDefault() 或 e.stopPropagation(),直接加修饰符:
-
@click.prevent—— 阻止链接跳转、表单提交等默认行为 -
@click.stop—— 阻止事件向上冒泡(比如点击按钮时不触发父级 div 的 click) -
@click.once—— 点击仅生效一次,之后自动解绑
注意事项
确保方法在 setup(组合式 API)或 methods(选项式 API)中正确定义;@click 可用于任意 HTML 元素(不只是 button),比如
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











