Logo

Vue3 事件冒泡踩坑实录：5种实用的阻止冒泡方案

author
YGHub·2024-11-18·9·字数：528 字·阅读时间：2 分钟

Vue Vue

在 Vue3 项目开发中，事件冒泡经常会导致一些意想不到的问题。比如点击子元素时，不小心触发了父元素的事件，或者在弹窗组件中点击内容区域却意外关闭了弹窗。

一、什么是事件冒泡？

事件冒泡是指当一个元素触发事件后，该事件会向上传播到父级元素，直到到达根元素。这个过程就像水中的气泡一样，从底部向上冒。

vue 
<template>
  <div @click="handleParentClick">
    父元素
    <div @click="handleChildClick">
      子元素
    </div>
  </div>
</template>
 
<script setup>
const handleParentClick = () => {
  console.log('父元素被点击')
}
 
const handleChildClick = () => {
  console.log('子元素被点击')
}
</script>
 

点击子元素时，控制台会输出：

vue 
子元素被点击
父元素被点击
 

二、5种阻止事件冒泡的方法

1. 使用 @click.stop 修饰符（推荐）

这是最简单直接的方式，Vue 提供的事件修饰符可以直接在模板中使用：

vue 
<template>
  <div @click="handleParentClick">
    父元素
    <div @click.stop="handleChildClick">
      子元素
    </div>
  </div>
</template>
 

2. 在事件处理函数中使用 event.stopPropagation()

vue 
<template>
  <div @click="handleParentClick">
    父元素
    <div @click="handleChildClick">
      子元素
    </div>
  </div>
</template>
 
<script setup>
const handleChildClick = (event) => {
  event.stopPropagation()
  console.log('子元素被点击')
}
</script>
 

3. 使用 @click.self 修饰符（针对特定场景）

当只想在点击元素本身而不是其子元素时触发事件：

vue 
<template>
  <div @click.self="handleParentClick">
    父元素
    <div @click="handleChildClick">
      子元素
    </div>
  </div>
</template>
 

4. 使用 @click.capture 和 .stop 组合（高级用法）

在某些复杂场景下，我们可能需要在捕获阶段就阻止事件传播：

vue 
<template>
  <div @click="handleParentClick">
    父元素
    <div @click.capture.stop="handleChildClick">
      子元素
    </div>
  </div>
</template>
 

5. 使用 preventDefault 和 stopPropagation 组合（完全阻止）

当需要同时阻止默认行为和冒泡时：

vue 
<template>
  <div @click="handleParentClick">
    父元素
    <div @click="handleCompleteStop">
      子元素
    </div>
  </div>
</template>
 
<script setup>
const handleCompleteStop = (event) => {
  event.preventDefault()
  event.stopPropagation()
  console.log('子元素被点击')
}
</script>
 

三、注意事项

1.不要过度使用：并非所有事件都需要阻止冒泡，要根据实际需求来决定。

2.性能考虑：在大量元素需要阻止冒泡时，建议使用事件委托方式处理。

3.调试技巧：如果发现事件处理异常，可以通过 console.log(event) 查看事件对象，帮助定位问题。

四、最佳实践

vue 
<template>
  <!-- 推荐：使用 .stop 修饰符 -->
  <div @click.stop="handleClick">
    简单场景使用
  </div>
 
  <!-- 推荐：复杂逻辑使用函数处理 -->
  <div @click="handleComplexEvent">
    复杂场景使用
  </div>
</template>
 
<script setup>
const handleComplexEvent = (event) => {
  // 判断是否需要阻止冒泡
  if (needToStop()) {
    event.stopPropagation()
  }
  // 其他业务逻辑
}
 
const needToStop = () => {
  // 根据业务逻辑判断是否需要阻止冒泡
  return true
}
</script>
 

总结

在 Vue3 中处理事件冒泡有多种方式，关键是要根据具体场景选择合适的方案。

一般情况下，使用 @click.stop 修饰符是最简单有效的方式。

对于复杂场景，可以考虑使用 event.stopPropagation() 在函数中进行更灵活的控制。

Preview

9

点个赞 ~

Vue Vue

版权申明： © 本文著作权归YGHub所有，未经YGHub网授权许可，禁止第三方以任何形式转载和使用本文内容。

Related article

基于微信小程序实现图片压缩、裁剪、尺寸调整的实践总结

YGHub

2025-01-02

4

Vue3 作用域插槽，提升组件复用性的利器

YGHub

2024-12-03

1

Nuxt3 中使用 localStorage 的正确姿势

YGHub

2024-12-01

3

Vue3 子组件 defineExpose 暴露方法无效的三种常见场景及解决方案

YGHub

2024-11-24

7

Vue3 组件通信实战，实现跨组件数据更新

YGHub

2024-11-21

8