在网页交互设计中,侧边导航菜单是很多站点常用的组件,当用户点击菜单以外的页面任意位置时自动关闭菜单,能避免用户手动寻找关闭按钮的麻烦,提升操作流畅度。实现这个功能的核心是利用DOM的事件冒泡机制,合理控制事件监听的范围和事件传播行为。

实现核心思路
要实现点击任意位置关闭侧边菜单,整体逻辑可以分为三步:
- 给侧边导航菜单元素绑定点击事件,阻止事件冒泡,避免点击菜单内部时触发关闭逻辑
- 给整个document对象绑定点击事件,当点击事件触发时,判断菜单是否处于展开状态,如果是则关闭菜单
- 处理菜单展开按钮的点击事件,点击按钮时切换菜单的展开和关闭状态,同时阻止事件冒泡避免触发document的关闭逻辑
原生JavaScript实现示例
首先我们先写基础的HTML结构,包含一个展开菜单的按钮和侧边导航菜单本身:
<button class="menu-toggle">展开菜单</button>
<div class="side-nav">
<ul>
<li>首页</li>
<li>产品中心</li>
<li>关于我们</li>
<li>联系我们</li>
</ul>
</div>
接下来是CSS样式,默认隐藏侧边菜单,展开时添加对应的类显示:
.side-nav {
position: fixed;
top: 0;
left: -250px;
width: 250px;
height: 100%;
background-color: #f5f5f5;
transition: left 0.3s ease;
padding: 20px;
box-sizing: border-box;
}
.side-nav.show {
left: 0;
}
.side-nav ul {
list-style: none;
padding: 0;
margin: 0;
}
.side-nav li {
padding: 10px 0;
border-bottom: 1px solid #ddd;
}
.menu-toggle {
margin: 20px;
padding: 8px 16px;
cursor: pointer;
}
最后是核心的JavaScript逻辑,实现点击任意位置关闭菜单的功能:
// 获取DOM元素
const menuToggle = document.querySelector('.menu-toggle');
const sideNav = document.querySelector('.side-nav');
// 点击展开按钮切换菜单状态
menuToggle.addEventListener('click', function(e) {
// 阻止事件冒泡,避免触发document的点击事件
e.stopPropagation();
sideNav.classList.toggle('show');
});
// 点击侧边菜单内部时,阻止事件冒泡,避免触发关闭逻辑
sideNav.addEventListener('click', function(e) {
e.stopPropagation();
});
// 给document绑定点击事件,点击任意位置关闭菜单
document.addEventListener('click', function() {
// 如果菜单处于展开状态,则关闭
if (sideNav.classList.contains('show')) {
sideNav.classList.remove('show');
}
});
关键逻辑说明
这里最核心的是stopPropagation方法的使用,该方法可以阻止事件继续向上冒泡。如果不阻止菜单内部和展开按钮的点击事件冒泡,那么点击这两个区域时,事件会传递到document的点击监听器中,导致菜单刚展开就被立刻关闭。
另外需要注意,给document绑定的点击事件不需要额外判断点击的目标元素,因为只要事件冒泡到document,就说明点击的不是菜单内部和展开按钮(这两个区域的冒泡已经被阻止),此时直接关闭菜单即可。
适配框架的实现思路
如果是使用Vue或者React等框架开发,核心逻辑和原生JS一致,只是DOM操作和事件绑定的方式有所区别。以Vue3为例,实现方式如下:
// Vue3组件逻辑
import { ref, onMounted, onUnmounted } from 'vue';
export default {
setup() {
const isNavShow = ref(false);
const sideNavRef = ref(null);
// 处理document点击事件
const handleDocumentClick = (e) => {
// 判断点击目标是否在侧边菜单外部
if (isNavShow.value && sideNavRef.value && !sideNavRef.value.contains(e.target)) {
isNavShow.value = false;
}
};
// 切换菜单状态
const toggleNav = (e) => {
isNavShow.value = !isNavShow.value;
// 阻止事件冒泡
e.stopPropagation();
};
onMounted(() => {
document.addEventListener('click', handleDocumentClick);
});
onUnmounted(() => {
document.removeEventListener('click', handleDocumentClick);
});
return {
isNavShow,
sideNavRef,
toggleNav
};
}
};
框架场景下可以使用contains方法判断点击目标是否是菜单的子元素,这种方式不需要给菜单内部单独绑定阻止冒泡的事件,逻辑更简洁。同时要注意在组件销毁时移除document的事件监听,避免内存泄漏。
侧边导航菜单click事件事件冒泡addEventListenerstopPropagation修改时间:2026-07-10 08:15:29