JavaScript 控制侧边栏显隐的核心是通过 classList.toggle 切换 CSS 类，配合 transition 或 @keyframes 实现平滑动画；需注意初始类、响应式判断、transform 优化、动画结束回调及无障碍支持。

JavaScript 实现侧边栏菜单，核心是控制 DOM 元素的显示/隐藏与 CSS 类切换；CSS 动画则通过 JS 触发类名变化，交由 CSS 的 transition 或 @keyframes 完成视觉过渡——两者配合自然、性能好、代码清晰。

用 JavaScript 控制侧边栏显隐

常见做法是给侧边栏容器（如 ）添加/移除一个表示“收起”或“展开”的类名，再由 CSS 定义该类下的宽度、位移或透明度等样式。

• 监听按钮点击（如汉堡图标），调用 document.getElementById('sidebar').classList.toggle('collapsed')
• 为避免首次加载时闪动，建议在 HTML 中默认加初始状态类（如 class="sidebar collapsed"），再用 JS 初始化逻辑
• 可结合 window.matchMedia 做响应式判断，在小屏才启用侧边栏交互，大屏直接显示

用 CSS transition 实现平滑展开/收起

比 JavaScript 手动逐帧动画更轻量，浏览器原生优化，推荐优先使用。

• 给侧边栏设置 transition: width 0.3s ease, opacity 0.2s ease（注意：width 从 0 → 240px 时，需确保元素有明确的 overflow: hidden 和固定 display）
• 若用 transform: translateX() 移动侧边栏（如从 -240px 到 0），性能更优，且不影响文档流
• 收起后建议延迟 display: none（用 JS 在 transition 结束后添加），避免仍占用布局空间

用 CSS @keyframes + JS 触发复杂动画

适合需要多阶段效果的场景，比如菜单项逐个淡入、带缩放的弹出动画。

• 定义动画：@keyframes slideIn { from { transform: translateX(-20px); opacity: 0; } to { transform: translateX(0); opacity: 1; } }
• JS 中先清空旧动画类（el.classList.remove('animate-in')），再 void el.offsetWidth 强制重排，最后加类触发重绘：el.classList.add('animate-in')
• 监听 animationend 事件做后续处理（如启用菜单项点击、释放锁）

实用技巧与避坑提醒

真实项目中容易忽略但影响体验的细节：

• 移动端要注意 touchstart 替代 click 防止 300ms 延迟
• 侧边栏遮罩层（overlay）建议用 position: fixed 并设 z-index 高于内容但低于菜单，点击遮罩关闭菜单
• 动画过程中禁用重复触发（例如加 if (sidebar.classList.contains('is-animating')) return）
• 无障碍支持：用 aria-expanded 和 aria-controls 同步状态，键盘 Esc 键关闭菜单