必须同时设置 data-bs-backdrop="static" 和 data-bs-keyboard="false" 才能完全禁用 Offcanvas 的关闭交互，二者缺一不可，且 HTML 中属性值须为字符串，JS 初始化时 backdrop/keyboard 参数须为布尔值。
data-bs-backdrop="static" 必须配 data-bs-keyboard="false"
只加 data-bs-backdrop="static" 不够，点击背景是拦住了，但用户按 esc 还是会关掉 offcanvas——这是最常被忽略的组合陷阱。
原因在于 Bootstrap 的关闭逻辑是“或关系”：触发任一条件（点击 backdrop 或按下 ESC）即隐藏。两个属性必须同时设置，且值必须是字符串 "static" 和 "false"（注意不是布尔值 false，也不是小写 false 拼错）。
-
data-bs-backdrop="static"：禁用点击遮罩层关闭 -
data-bs-keyboard="false"：禁用 ESC 键关闭 - 漏掉
bs-前缀（比如写成data-backdrop）会导致完全失效 - 在 JS 初始化时传对象参数，也必须用布尔值
backdrop: false或keyboard: false，不能传字符串（否则 Blazor 场景会报"Option 'backdrop' provided type 'string' but expected type 'boolean'"错误）
JS 初始化时 backdrop 参数类型要分清 HTML vs JS
HTML 属性和 JS 构造函数对 backdrop 的类型要求相反：前者认字符串，后者认布尔值。混用就炸。
比如你在按钮上写 data-bs-backdrop="static"，Bootstrap 会自动解析为禁用点击；但若用 JS 手动 new bootstrap.Offcanvas(el, { backdrop: 'static' })，就会报错——因为 JS API 要求 backdrop: false 表示禁用，backdrop: true（默认）才启用。
- HTML 中：
data-bs-backdrop="static"✅，data-bs-backdrop="false"❌（会被当作文本 backdrop，不生效） - JS 中：
{ backdrop: false }✅，{ backdrop: 'static' }❌（类型错误） - Blazor 场景下，别用 HTML 属性传参，直接在 JS 里 new 实例时传
{ backdrop: false, keyboard: false }
背景滚动没锁住？不是 overflow 问题，是 class 冲突
Offcanvas 打开后背景还能滚，往往不是因为你没设 data-bs-scroll="false"，而是你手动加了 overflow: hidden 或删了 modal-open 类，结果干扰了 Bootstrap 自身的状态管理。
正确做法是信任 Bootstrap 的默认行为：data-bs-scroll="false"（默认就是 false）已禁止背景滚动，它会自动给 <body> 加 modal-open 类并控制 padding 补偿。你额外干预反而容易引发“左跳抖动”或嵌套弹窗滚动失控。
- 不要在 CSS 里写
body { overflow: hidden !important }，会和多层 Offcanvas 冲突 - 不要手动增删
modal-open类，让 Bootstrap 控制 - 如果真要允许背景滚动（比如长表单场景），才显式加
data-bs-scroll="true"
Offcanvas 内容超长却不能滚动？重点在 .offcanvas-body
背景锁住了，但 Offcanvas 自己内容拉不到底——这不是 backdrop 设置问题，是高度和溢出没配对。
Offcanvas 默认 .offcanvas 容器是 overflow: hidden，子元素不会自动可滚。必须明确给内容区（通常是 .offcanvas-body）设高度限制和 Y 轴滚动。
- 加
max-height: 70vh+overflow-y: auto到.offcanvas-body - 避免设
height: 100%，它依赖父容器高度，而 Offcanvas 高度是动态计算的 - iOS Safari 对
vh有缩放 bug，稳妥起见用max-height: calc(100vh - 120px)（减去 header/footer 高度）
实际开发中，最容易卡住的地方不是 backdrop 属性本身，而是 HTML 和 JS 两套参数体系混用、或者以为“禁用 backdrop”就等于“锁死一切交互”。它只管点击和键盘，滚动、焦点、tab 顺序、可访问性（如 enforceFocus）都得单独理。
