卡片局部滚动需同时满足高度被框住、不被父级压缩、滚动上下文不被截断三条件,否则scrollTop恒为0;根本原因是.card无高度约束导致.card-body的height:100%计算为0,须逐级锚定html/body/.card/.card-body高度并设overflow-y:auto。

卡片局部滚动不是加个 overflow-y: auto 就能动的——它必须同时满足「高度被框住」「不被父级压缩」「滚动上下文不被截断」三个硬条件,否则 scrollTop 永远是 0,滚动条也不出现。
为什么 .card-body 设了 overflow-y: auto 还是不滚
根本原因是 Bootstrap 的 .card 默认没高度约束,子元素 .card-body 的 height: 100% 计算结果为 0。常见失效组合:
-
.card缺少height或max-height(比如只用.h-100,但父容器没高) -
.card-body写了height: 100%—— 错!应改用max-height: 100%+overflow-y: auto - 整个页面的
html, body没设overflow: hidden,导致滚轮穿透到全局 -
.card外层用了transform或filter,隔离了滚动上下文
Bootstrap 5 中可靠启用卡片局部滚动的写法
不用 JS、不改框架源码,纯 CSS 可解。关键在三层高度锚定:
- 给
html, body加height: 100%; overflow: hidden; - 给
.card显式设高:height: 400px或max-height: 60vh(避免用h-100直接套) - 给
.card-body设max-height: 100%; overflow-y: auto; overflow-x: hidden; - 若
.card是 Flex 子项,加flex-shrink: 0防被压缩
移动端卡片滚动卡顿或点不动?检查这三处
iOS 和 Android WebView 对局部滚动更敏感,漏一项就可能失灵:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
-
<meta name="viewport">必须同时含width=device-width和initial-scale=1.0,缺一不可 -
.card-body必须加-webkit-overflow-scrolling: touch;(即使已废弃,2026 年仍是 iOS 惯性滑动唯一可靠开关) - 避免在
.card或其父级上用border-radius却不配overflow: hidden——圆角会裁掉滚动条触发区,导致“能看不能滑”
滚动后内容被 sticky 表头遮住怎么办
当 .card-body 里有 position: sticky 的表头时,scrollIntoView() 或锚点跳转会把目标顶到容器顶部,直接盖住:
- 不要在
html上设scroll-padding-top - 必须在
.card-body上加:scroll-padding-top: 48px;(值等于 sticky 元素的实际占位高度,含 padding/border) - 该值不能靠猜,要用 DevTools 测量真实像素,单位用
px或rem
最常被忽略的是:卡片局部滚动的「高度链」必须从 html 开始一级级往下压,中间任何一环用 % 或 min-height 代替显式高度,都会让整条链断裂。这不是样式问题,是浏览器渲染引擎的计算前提。


















