侧边栏抽屉应使用 transform: translateX() 实现，避免 left/margin 引发重排；需配合 transition: transform、cubic-bezier 曲线、will-change 优化性能；Bootstrap 5 的 offcanvas 需覆盖默认样式并处理遮罩点击穿透与手势关闭逻辑。
侧边栏抽屉效果必须用 transform 而非 left / margin
直接改 left 或 margin-left 会导致浏览器频繁重排（reflow），动画卡顿，且无法触发硬件加速。正确做法是用 transform: translateX() —— 它只触发重绘（repaint），性能好，且在移动端也顺滑。
常见错误：给侧边栏加 transition: left 0.3s ease，结果动画掉帧、iOS 上闪屏。这是因为 left 属于布局属性，每次变化都要重新计算文档流。
实操建议：
- 初始状态设为
transform: translateX(-100%)（完全隐藏） - 展开时改为
transform: translateX(0) - 务必搭配
transition: transform 0.3s cubic-bezier(0.34, 1.56, 0.64, 1)—— 这个贝塞尔曲线比默认ease更自然，收尾不生硬 - 加上
will-change: transform（仅在需要极致性能时启用，避免滥用）
Bootstrap 5 的 .offcanvas 已内置抽屉，但默认无平滑过渡
Bootstrap 5 原生的 .offcanvas 组件默认用 visibility + opacity 控制显隐，动画是“淡入淡出”，不是横向抽屉。要改成平滑抽屉，得覆盖其 CSS 行为。
立即学习“前端免费学习笔记（深入）”；
关键点：
- 删掉默认的
opacity和visibility过渡逻辑，否则会和transform冲突 - 重写
.offcanvas-start的transform和transition - 确保父容器（如
.offcanvas-backdrop）不影响侧边栏定位，推荐设position: fixed并指定top/bottom/height
示例补丁 CSS：
.offcanvas-start {
transform: translateX(-100%);
transition: transform 0.3s cubic-bezier(0.34, 1.56, 0.64, 1);
}
.offcanvas-start.show {
transform: translateX(0);
}
.offcanvas-backdrop {
z-index: 1049; /* 确保在 offcanvas 下层但高于内容 */
}点击遮罩层关闭时，需阻止事件穿透到侧边栏内部
Bootstrap 默认点击 .offcanvas-backdrop 关闭抽屉，但如果侧边栏里有按钮、链接或表单，用户快速点击边缘区域，可能误触内部元素，导致关闭后又立刻触发其他行为（比如跳转或提交）。
根本原因是 .offcanvas-backdrop 和 .offcanvas 是同级元素，且 backdrop 在 z-index 上略低 —— 某些情况下事件会“漏”过去。
解决方式：
- 给
.offcanvas加pointer-events: none，再给其子容器（如.offcanvas-body）单独设pointer-events: auto - 或者更稳妥：监听
.offcanvas-backdrop的click，调用bootstrap.Offcanvas.getInstance(...).hide()，并e.stopPropagation() - 避免给整个
.offcanvas设cursor: pointer，否则会误导用户以为整块都可点
移动端手势关闭（滑动关闭）需要额外处理
纯 CSS 实现不了滑动手势，必须用 JS 监听 touchstart/touchmove。但要注意：Bootstrap 的 Offcanvas 实例不暴露拖拽 API，得自己算位移。
核心逻辑是判断水平滑动距离是否超过阈值（如 50px），再触发关闭。容易踩的坑：
- 没禁用默认滚动行为（
e.preventDefault()在touchmove里漏了），导致页面跟着滑 - 在
touchend后直接 hide()，但没还原transform，造成视觉残留 - 未考虑
scrollY影响，导致在长页面中手势识别偏移
建议只对 .offcanvas-start 的根元素绑定，且加防抖（避免快速连点触发多次）。
复杂点在于：CSS 平滑抽屉只是动画表现，真正控制开闭状态的仍是 JS。很多人只调 CSS，忘了同步更新 .show 类或 Bootstrap 实例状态，结果动画播完了，但 isShown 还是 true，下一次点击就失效。
