Vue 中 @click.left 可精准监听鼠标左键点击,无需手动判断 event.button,自 Vue 2.2 起原生支持,语义清晰、兼容性好,可与其他修饰符如 .prevent、.stop、.once 等自由组合。

Vue 中直接用 @click.left 就能精准监听鼠标左键点击,无需判断 event.button 或额外阻止默认行为。它在 Vue 2.2+ 和 Vue 3(通过 v-on)中都原生支持,语义清晰、写法简洁。
left 修饰符的基本用法
它只在用户真正按下鼠标左键(主按钮)时触发,自动过滤右键、中键、触控板模拟点击等干扰。和普通 @click 不同,它不依赖事件冒泡路径或 button 值校验,底层已做标准化处理。
- 写法统一:支持
@click.left(推荐)或v-on:click.left - 兼容性好:Vue 2.2 起支持,Vue 3 完全保留,无需 polyfill
- 不干扰其他逻辑:不影响
.prevent、.stop等修饰符组合使用
常见写法与注意事项
注意不要混用 @contextmenu 或手动判断 event.button === 0 来“模拟”左键——那样既冗余又容易出错(比如某些触控设备 button 值不标准)。
- ✅ 正确:
<button>左键点我</button> - ❌ 不必要:
<button> e.button === 0 && handleClick()"></button> - ⚠️ 注意:如果元素同时绑定了
@click和@click.left,两者会各自触发(不是互斥),需按需取舍
结合其他修饰符的实用场景
left 修饰符常和其他修饰符联用,解决具体交互问题:
立即学习“前端免费学习笔记(深入)”;
-
@click.left.prevent:左键点击时阻止默认行为(如链接跳转) -
@click.left.stop:只响应本元素左键点击,不向父级冒泡 -
@click.left.once:左键仅触发一次,适合初始化操作或防重复提交 - 与
.self组合:@click.left.self确保必须直接点击该元素本身(子元素点击无效)
为什么不用自己判断 button?
虽然原生 DOM 事件中 event.button === 0 表示左键,但实际中存在兼容性隐患:
- 部分 macOS 触控板或绘图板可能返回非标准 button 值
- 某些浏览器对辅助设备支持不一致
- Vue 的
.left内部做了 normalize,更可靠 - 代码可读性差,维护成本高


















