Flex实现H5全屏弹窗上下结构固定:外层容器设display: flex、flex-direction: column、height: 100dvh;header/footer固定高度,main用flex: 1且overflow-y: auto;遮罩与弹窗同级fixed定位,z-index分层。

用 Flex 实现 H5 全屏弹窗的上下结构固定,核心是让弹窗容器形成一个垂直方向的弹性布局,顶部和底部区域高度固定,中间内容区自适应并可滚动。关键不在“全屏”本身,而在内部结构的尺寸控制与流式行为隔离。
父容器必须设为 flex column 且高度占满视口
弹窗最外层(比如 .popup-wrapper)需满足两个前提:
- display: flex + flex-direction: column,确保子元素按垂直顺序排列
-
高度必须明确为视口高度,推荐使用
height: 100dvh(比100vh更稳定,避免 iOS 键盘弹起时抖动) - 若弹窗是
position: fixed,务必加上inset: 0或top: 0; left: 0; right: 0; bottom: 0,否则它脱离文档流后无尺寸基准
顶部、底部固定高度,中间用 flex: 1 占满剩余空间
三个子区块按顺序排列:header → main → footer。其中:
- header 和 footer 设置固定高度(如
height: 48px或flex: 0 0 48px),不伸缩也不压缩 - main 区域写
flex: 1; overflow-y: auto,这样它会自动填满 header 和 footer 之间的所有空隙,并在内容超长时允许内部滚动 - 注意不要给 main 加
height: 100%,那会破坏 flex 的自动分配逻辑
滚动行为要限制在中间区域,不能影响整体弹窗
常见错误是整个弹窗可滚动,导致 header 和 footer 跟着移出视图。解决方法:
- 确保只有
main容器有overflow-y: auto,且其父级(即 flex container)没有设置overflow - main 内部子元素不要用
position: absolute脱离流,否则高度计算失效 - 在 iOS 上,如果键盘弹起后底部被顶起,可配合
visualViewport监听或使用env(safe-area-inset-bottom)微调 footer 的 padding-bottom
遮罩层与弹窗分离,避免布局干扰
遮罩(overlay)和弹窗内容应是兄弟级元素,都挂载在同一个 fixed 定位的父容器下:
- overlay 设置
position: fixed; inset: 0; background: rgba(0,0,0,.7) - 弹窗内容块紧随其后,同样
position: fixed; inset: 0,再在其内部启用 flex column 布局 - 两者通过
z-index区分层级,避免遮罩把弹窗内容盖住


















