用transform: translateX()配合transition实现侧边栏滑动展开,需设position: fixed、初始translateX(-100%)、展开时translateX(0),并添加transition: transform 0.3s ease和will-change: transform提升性能,避免重排与闪烁。
直接用 transform: translateX() 配合过渡动画,比 display 切换或 height 动画更可靠,不会触发重排,也避免内容闪烁。关键不是“怎么动”,而是“动的时候别卡、别跳、别遮不住内容”。
常见错误是把导航栏写在 <body> 里但没设 position: fixed 或 absolute,结果滚动页面时它跟着跑;或者用 visibility: hidden + opacity 混搭,导致点击穿透或焦点丢失。
position: fixed(推荐)或 absolute,并指定 top: 0、left: 0、height: 100vh
transform: translateX(-100%) 把它完全推到屏幕外左侧transform: translateX(0),配合 transition: transform 0.3s ease
will-change: transform 提升渲染层,尤其在低端安卓 WebView 里能明显减少卡顿别用 onclick="toggleNav()" 写在 HTML 里,也别直接操作 style.transform。用 class 切换来解耦样式和逻辑,同时避免内联样式污染和重复绑定。
容易踩的坑是:点击按钮后没阻止默认行为,导致页面跳转;或者没监听 click 以外的关闭方式(比如 Esc 键、点背景蒙层),造成用户无法退出。
立即学习“前端免费学习笔记(深入)”;
sidebar--open,CSS 里定义该类下的 transform: translateX(0)
addEventListener('click', () => sidebarEl.classList.toggle('sidebar--open'))
document.addEventListener('keydown', e => e.key === 'Escape' && sidebarEl.classList.remove('sidebar--open'))
<div class="sidebar-overlay">)加 click 事件,只调 classList.remove(),不 toggle,避免误触二次展开大概率是蒙层元素没有实际尺寸或被其他元素挡住。iOS Safari 和部分安卓浏览器对 click 事件有 300ms 延迟,且要求目标元素可交互(比如有 cursor: pointer 或 touch-action: manipulation)。
另一个隐蔽问题是:蒙层 z-index 比导航栏低,或者父容器用了 overflow: hidden 把它裁掉了。
position: fixed、top: 0、left: 0、width: 100vw、height: 100vh
touch-action: manipulation 消除 300ms 延迟,再补一句 cursor: pointer 确保桌面端也能点z-index:蒙层建议设 z-index: 998,导航栏设 z-index: 999,确保层级关系清晰overflow: hidden,把它移到 <body> 下直接子元素,绕过嵌套裁剪这是滚动条消失又出现造成的——导航展开时页面宽度撑满,滚动条隐藏;关闭后滚动条回来,内容向左偏移。不是动画问题,是布局抖动。
根本原因是 body 默认允许滚动,而侧边栏是 fixed 定位,不占文档流,但它的出现/消失会影响视口可用宽度计算。
body 加 overflow: hidden,关闭时恢复 overflow: auto
padding-right 模拟滚动条宽度,不同系统滚动条宽度不一致(Windows ~17px,macOS 隐藏式,iOS 无)overscroll-behavior: contain 在容器上,确认它没干扰到 body 的滚动行为scrollbar-width: none(Firefox)或 ::-webkit-scrollbar { display: none },这会破坏原生滚动体验,且无法解决抖动