Bootstrap 模态框大小修改 Modal宽高度配置-Bootstrap教程-PHP中文网

直接改 modal-dialog 的 max-width 和 max-height 是唯一稳定生效的路径，因 Bootstrap 居中依赖 transform 锚点，width 无效且破坏定位；需配合 CSS 变量或自定义 class 覆盖，并调用 handleUpdate() 刷新布局。

bootstrap 模态框大小修改 modal宽高度配置

直接改 modal-dialog 的 max-width 和 max-height 是唯一稳定生效的路径，其他方式基本会失效或引发定位/滚动异常。

为什么 `style="width: 800px"` 或 `data-bs-width` 不起作用

Bootstrap 本身不提供 width、height 等配置项，data-bs-* 属性里也没有这类参数；width 在 flex 定位下会被忽略，真正参与居中计算的是 max-width；浏览器对原生表单控件和模态结构有强 UA 样式约束，硬设 width 只会破坏 transform: translate(-50%, -50%) 的锚点逻辑。

jQuery 写法如 $('#myModal').modal({ width: '900px' }) 直接报错——Bootstrap 原生 JS 不支持该配置
style="width: 90%" 在 modal-dialog 上无效，因为其父容器（modal）未设 display: flex，且居中靠 transform，不是靠宽度撑开
改 modal-content 的 width 会导致内容被裁切或左右留白异常，因它只是子元素，不控制外层布局尺寸

正确设置 Modal 宽度：用 class 或 CSS 变量覆盖 `max-width`

推荐加自定义 class 到 modal-dialog 元素，再在 CSS 中重置 max-width，兼容所有 Bootstrap 5.x 版本，不影响响应式断点逻辑。

HTML 中：<div class="modal-dialog modal-wide-850"> <li>CSS 中：<code>.modal-wide-850 { max-width: 850px; }
若需响应式，配合媒体查询：@media (min-width: 992px) { .modal-wide-850 { max-width: 90vw; } }
Bootstrap 5.2+ 更推荐用 CSS 变量：<div class="modal-dialog" style="--bs-modal-max-width: 850px;">，它优先级高于类名，且自动适配断点<li>避免只写 <code>width: 850px——这会让 transform 偏移计算错乱，视觉上偏右偏下

高度控制必须配合 `modal-body` 的 `max-height` 和布局

Modal 高度不能只靠 max-height 控制，因为默认 modal-content 是 display: block，内容会无限制撑高；滚动条出现在页面 body 上，而不是框内，说明 modal-body 没被约束。

VPS Bootstrap

从零启动全新 VPS，完成 OpenClaw 完整部署，包括备份/恢复及恢复后验证。用于 OpenClaw 部署。

下载

给 modal-body 加 max-height: calc(100vh - 180px)（减去 header + footer + padding 高度），并设 overflow-y: auto
同时确保 modal-content 是 display: flex; flex-direction: column，否则 max-height 不生效
如果用了 modal-fullscreen，记得检查父容器是否设了 overflow: hidden，否则全屏可能被截断
禁用动画时（data-bs-animation="false"），要手动清 transform：modalDialog.style.transform = "none"，否则高度计算偏差

动态修改后必须调用 `handleUpdate()` 否则位置/滚动错乱

JS 手动改完 modal-dialog 的 max-width 或 max-height 后，如果不刷新内部状态，Bootstrap 仍按旧尺寸做 transform 偏移和滚动区域计算，导致模态框“飘”在屏幕一角、modal-body 滚动失效、点击关闭按钮无反应。

Bootstrap 5.2+ 必须调用：bootstrap.Modal.getInstance(modalEl).handleUpdate()
该方法需在 Modal 已初始化后执行，比如在 shown.bs.modal 事件回调里改尺寸再调用
如果 Modal 尚未打开，可先调用 new bootstrap.Modal(modalEl) 初始化实例，再改尺寸+调用 handleUpdate()
漏掉这步是线上最常见“宽高改了但看起来没变”的原因——不是样式没生效，而是定位逻辑没更新

真正难的不是设宽高，而是让整个尺寸链（modal → modal-dialog → modal-content → modal-body）都对齐约束逻辑，尤其当涉及移动端视口变化、Safari 地址栏收放、或禁用动画时，任意一环松动都会导致滚动/定位/点击全部失常。