该用 Offcanvas——Bootstrap 5.2+ 专为侧边/底部抽屉设计，原生支持 placement、backdrop 和 ESC 关闭；Modal 强行改造会破坏动画、焦点和响应式逻辑。
抽屉弹窗该用 Modal 还是 Offcanvas？
Bootstrap 5.2+ 正式引入 Offcanvas 组件，专为侧边/底部抽屉设计；Modal 是模态框，垂直居中、遮罩层默认全屏，强行改成抽屉会破坏动画逻辑、键盘焦点和响应式行为。直接用 Offcanvas——它原生支持 data-bs-placement="end"、自动处理 backdrop 和 esc 关闭，省掉一堆 hack。
基础结构必须包含的 4 个关键属性
漏掉任意一个都可能导致不显示、无法关闭或样式错乱：
-
class="offcanvas offcanvas-end"：固定类，offcanvas-end表示从右侧滑入（也可用offcanvas-start/offcanvas-top/offcanvas-bottom） -
id="detailDrawer"：必须有唯一id，否则 JS 初始化或触发失败 -
tabindex="-1"：确保键盘可聚焦，影响无障碍访问和 ESC 关闭 -
data-bs-backdrop="true"或"static"：控制点击遮罩是否关闭，后台详情通常设为true（点遮罩即收起）
示例最小结构：
<div class="offcanvas offcanvas-end" id="detailDrawer" tabindex="-1" data-bs-backdrop="true">
<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>
JS 触发时传参渲染内容的两种安全方式
后台详情页常需根据不同 ID 加载数据，不能写死内容。避免在 HTML 中硬编码多个 offcanvas 实例（维护成本高），推荐以下任一做法：
- 用
new bootstrap.Offcanvas(...)手动初始化后，通过getElementById动态填充offcanvas-body内容，再调用show() - 监听
show.bs.offcanvas事件，在回调里发起 AJAX 请求，成功后再更新 DOM 并保持显示状态（注意：请求期间不要阻塞动画） - 禁止直接修改
innerHTML后再调用show()——若 offcanvas 尚未初始化，show()会静默失败
典型触发代码（配合按钮 data-bs-target="#detailDrawer"）：
document.getElementById('detailDrawer').addEventListener('show.bs.offcanvas', function (e) {
const userId = e.relatedTarget.getAttribute('data-user-id'); // 从触发按钮取 ID
fetch(`/api/users/${userId}`)
.then(r => r.json())
.then(data => {
document.querySelector('.offcanvas-body').innerHTML = `
<strong>姓名：</strong>${data.name}<br><strong>邮箱：</strong>${data.email}
`;
});
});
后台场景下容易被忽略的 3 个细节
不是“能弹出来”就完事了：
-
offcanvas默认宽度是400px，后台详情字段多时明显不够——用自定义 CSS 覆盖.offcanvas-end { width: 600px }，并加@media (max-width: 992px)降级回 400px - 如果详情页本身用了
overflow-x: hidden（常见于固定侧边栏布局），会导致 offcanvas 遮罩层不铺满视口——检查父容器的overflow，必要时对.offcanvas-backdrop设position: fixed - 关闭后，offcanvas 的
style会残留display: block，若后续 JS 依赖offsetParent判断可见性，可能出错——监听hidden.bs.offcanvas事件手动清理或改用getComputedStyle
Offcanvas 的动画依赖 transform 和 transition，别用 display: none 强制隐藏，否则动画中断、状态错乱。
