Vue 3 中事件修饰符按从左到右顺序依次执行,如@click.stop.prevent先执行stopPropagation再preventDefault;.passive与.prevent不可共存,常用安全组合包括@submit.prevent、@scroll.passive等。

Vue 3 中多个事件修饰符可以连写,用英文句号 . 连接,例如 @click.stop.prevent 或 @submit.prevent.stop。它们不是并行生效,而是按**从左到右的顺序依次执行**——就像给事件处理函数套了一层又一层包装。
修饰符组合的本质是执行顺序
Vue 编译模板时,会把每个修饰符转为对原生 event 对象的操作,并按书写顺序插入到你的处理器之前:
-
@click.stop.prevent等价于:function ($event) { $event.stopPropagation(); $event.preventDefault(); handler($event); } -
@click.prevent.stop则先调用preventDefault(),再调用stopPropagation()—— 顺序变了,但实际效果通常一致(因为两者互不影响) - 但某些组合有明确依赖关系,比如
.passive和.prevent不能共存:浏览器规定 passive 监听器禁止调用preventDefault(),Vue 会直接忽略.prevent或报警告
常用且安全的组合模式
以下写法在业务中高频出现,逻辑清晰、无冲突:
-
@click.stop.prevent:常用于按钮内嵌在可点击容器中,既要阻止冒泡,又要防止默认行为(如标签跳转) -
@submit.prevent:表单提交最基础的组合,拦截刷新,走 Vue 的异步提交逻辑 -
@scroll.passive:滚动监听必备,提升性能;注意它不能和.prevent同时使用 -
@keyup.enter.stop:回车触发搜索,同时避免回车在表单中意外触发表单提交或冒泡到父级
需要特别注意的限制场景
不是所有修饰符都能随意叠加,关键要看浏览器机制和 Vue 内部实现:
-
.passive和.prevent冲突:声明为 passive 后,事件回调中调用preventDefault()无效,Vue 也会静默忽略.prevent -
.once和其他修饰符兼容性好,但要注意它只作用于整个事件绑定,即“第一次触发时,先执行所有修饰逻辑,再执行 handler,之后解绑” - 自定义组件上使用
.native(Vue 2)已移除;Vue 3 中需用v-on:click.capture.native类写法不再支持,应通过emits显式抛出事件,或用v-bind="$attrs"透传原生事件
按键与鼠标修饰符也能参与组合
除了 .stop .prevent 这类通用修饰符,按键(如 .enter、.ctrl)和鼠标(如 .left、.exact)修饰符同样支持连写:
-
@click.ctrl.exact="handleCtrlClick":仅按 Ctrl 键(不带其他键)时触发 -
@keyup.shift.tab="onShiftTab":Shift + Tab 组合键释放时触发 -
@mousedown.right.stop="onRightClick":右键按下、且阻止冒泡
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











