本文介绍一种不直接操作 `document.body.style.overflow` 的现代方案，利用 html `data-*` 属性与 css 类动态控制页面滚动禁用，避免重排重绘，提升 submenu 侧滑菜单的 ux 稳定性与可维护性。
在实现侧滑式子菜单（如从右侧弹出的 #login-subMenu）时，常见的误区是在 JavaScript 中反复直接修改 document.body.style.overflow。这种写法不仅耦合度高、难以维护，还极易引发布局抖动（layout thrashing）：当 overflow: hidden 被移除时，body 宽度可能因滚动条消失而突然变宽，触发浏览器强制重排（reflow）和重绘（repaint），尤其在配合 CSS 过渡动画时，会导致菜单位移卡顿、内容跳闪等严重 UX 问题。
✅ 正确做法是：将滚动控制逻辑完全交由 CSS 类管理，JS 仅负责类的增删/切换。例如，定义一个语义化类 .is-subMenu 作用于 元素，并在该类存在时统一禁用整个视口的滚动：
.is-subMenu {
overflow: hidden;
}
.is-subMenu #login-subMenu {
translate: 0% 0%; /* 激活菜单显示 */
}对应地，HTML 中无需硬编码事件监听器，而是使用声明式 data-toggle-class 属性标识可交互元素：
<div id="right_nav"> <button type="button" data-toggle-class="is-subMenu">Help</button> </div> <div id="login-subMenu"> <button type="button" data-toggle-class="is-subMenu">Close ✕</button> </div>
JavaScript 部分极简且健壮——只监听 上的冒泡点击，通过 closest() 定位带 data-toggle-class 的按钮，并统一调用 classList.toggle()：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“前端免费学习笔记（深入）”；
const elHtml = document.documentElement;
elHtml.addEventListener("click", (evt) => {
const elBtn = evt.target.closest("[data-toggle-class]");
if (!elBtn) return;
elHtml.classList.toggle(elBtn.dataset.toggleClass);
});⚠️ 注意事项：
- 永远避免 event.target !== USERINFO 这类松散判断：它无法处理子元素点击（如 内的图标）、事件冒泡中断或动态 DOM 变更；
- 不要混用 style.overflow 和 classList：CSS 类应成为唯一可信源，否则样式优先级冲突将导致行为不可预测；
- 是更优作用域：相比 document.body， 元素能更可靠地控制 viewport 级滚动（尤其在移动端 Safari 中）；
- 动画需配合 translate 而非 right/left：示例中使用 translate: -100% 隐藏菜单，硬件加速更流畅，且不受父容器定位限制。
最后强调：全局禁用滚动应作为最后手段。若菜单高度可控，更推荐对
应用 overscroll-behavior: none 或仅限制菜单容器自身滚动（#login-subMenu { overflow-y: auto }），以保持主文档流自然、无障碍可访问。本方案提供的 .is-subMenu 类机制，既满足功能需求，又为未来扩展（如暗色主题 .is-dark）预留了清晰、可组合的架构基础。
