Bootstrap 5.2+ 内置 offcanvas 组件实现抽屉弹窗，需确保版本≥5.2、正确使用 data-bs-* 属性、tabindex="-1" 及 JavaScript 实例方法控制，避免手动 DOM 操作。
Bootstrap 本身没有原生的“抽屉弹窗”（Drawer）组件，offcanvas 就是它的官方实现——不是插件，不是第三方扩展，是 Bootstrap 5.2+ 内置的核心组件。
确认你用的是 Bootstrap 5.2 或更高版本
旧版 Bootstrap（5.1 及之前）不支持 offcanvas，强行复制文档代码会完全失效。检查你引入的 CSS/JS 文件 URL 或本地版本号：
https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css
若用 npm 安装，运行：npm list bootstrap 确认版本 ≥ 5.2.0。
- 低于 5.2：升级或改用
modal+ 自定义 CSS 模拟抽屉（不推荐，维护成本高） - 使用 CDN 时注意路径中明确带版本号，避免缓存旧资源
- CDN 版本更新快，但国内访问可能不稳定，建议本地化或用 jsDelivr 镜像
基础用法：HTML 结构必须包含 data-bs-* 属性
offcanvas 依赖 data-bs-toggle="offcanvas" 触发，且目标元素需有 id 和 class="offcanvas"。漏掉任一属性，点击无反应。
典型结构：
<!-- 触发按钮 --> <button class="btn btn-primary" type="button" data-bs-toggle="offcanvas" data-bs-target="#myDrawer"> 打开抽屉 </button> <p><!-- 抽屉容器 --> <div class="offcanvas offcanvas-start" tabindex="-1" id="myDrawer"> <div class="offcanvas-header"> <h5 class="offcanvas-title">我的抽屉</h5> <button type="button" class="btn-close" data-bs-dismiss="offcanvas"></button> </div> <div class="offcanvas-body"> <p>内容在这里</p> </div> </div>
-
offcanvas-start表示从左侧滑入；换成offcanvas-end/offcanvas-top/offcanvas-bottom控制方向 -
tabindex="-1"是必需的，否则键盘无法聚焦关闭 -
data-bs-dismiss="offcanvas"必须写在关闭按钮上，不能只靠点击遮罩层（默认支持，但按钮逻辑要完整）
JavaScript 控制：避免直接操作 DOM
不要用 document.getElementById().classList.toggle() 手动显隐——这会绕过 Bootstrap 的事件、动画和 backdrop 处理，导致遮罩残留、esc 键失效、多次触发异常。
正确方式是调用实例方法：
const myDrawer = new bootstrap.Offcanvas(document.getElementById('myDrawer'));
myDrawer.show(); // 打开
myDrawer.hide(); // 关闭
myDrawer.toggle(); // 切换- 实例只需创建一次，重复
new会报错“Offcanvas is already initialized” - 监听事件用
myDrawer._element.addEventListener('shown.bs.offcanvas', ...)，不要监听click或transitionend - 如果抽屉内容是动态加载的（如 AJAX），在
shown.bs.offcanvas回调里操作 DOM，确保动画完成后再渲染
常见样式冲突与响应式陷阱
抽屉在小屏（sm 以下）默认启用，但在 md 及以上默认退化为普通 modal（即居中浮层），这是 Bootstrap 的响应式设计，不是 bug。
- 想强制始终以抽屉形式出现，去掉
offcanvas-md类，并覆盖 CSS：.offcanvas { position: fixed; } @media (min-width: 768px) { .offcanvas { display: block !important; } } - 抽屉内表单控件（如
select、date）在 iOS Safari 中可能被底部工具栏遮挡，需加viewport-fit=cover并用env(safe-area-inset-bottom)调整 padding - 嵌套滚动时，
offcanvas-body默认不设max-height，内容超长会撑出页面，应手动加style="max-height: calc(100vh - 120px); overflow-y: auto;"
抽屉的“抽”感来自 transform 动画和 backdrop 渐变，删掉 bootstrap.min.css 里的 .offcanvas.show 相关规则，或者禁用 transition，都会让交互失去反馈——这点容易被忽略，调试时别只盯着 JS。
