H5移动端横屏视频全屏适配需结合CSS媒体查询、viewport设置、flex/相对单位布局及JS方向监听,通过orientation或aspect-ratio媒体特性调整容器样式,配合object-fit控制视频填充方式,实现视觉全屏而非强制原生全屏。

在 H5 中实现移动端横屏视频全屏适配,核心不是靠媒体查询“强制全屏”,而是结合 CSS 媒体查询 + 视口控制 + 视频容器样式 + JavaScript 监听方向变化,让视频在设备横屏时自然撑满可视区域。媒体查询本身只能响应宽高比或宽度变化,无法直接触发全屏行为,但可作为样式适配的重要一环。
设置合理的 viewport 和初始布局
确保页面能正确响应旋转,首先要规范视口声明:
去掉 user-scalable=no 可能影响体验,但若业务强依赖横屏播放(如教育类视频课),保留它可避免用户误缩放导致布局错乱。同时,视频容器建议用相对单位(如 100vw/100vh)或 flex 布局,避免固定像素卡死。
用媒体查询区分横竖屏并调整容器样式
通过 orientation 或 aspect-ratio 媒体特性适配不同方向:
-
基于 orientation(推荐初用):
@media (orientation: landscape) { .video-wrap { width: 100vw; height: 100vh; } }
注意:iOS Safari 对orientation支持良好,但部分安卓浏览器在快速旋转时可能有延迟或误判;建议配合 JS 使用。 -
基于宽高比(更稳定):
@media (min-aspect-ratio: 16/9) { .video-wrap { height: 100vh; width: auto; } }
横屏时屏幕宽高比通常 > 1,竖屏时 min-aspect-ratio: 1/1 或1.2/1可更稳妥捕获横屏态。
用 JavaScript 监听方向变化并补位控制
媒体查询是被动响应,而 window.orientation 已废弃,应改用 screen.orientation 或 resize 事件辅助判断:
- 监听
resize并比较window.innerWidth与window.innerHeight: - 检测到横屏(
innerWidth > innerHeight)时,给视频容器添加.landscape-mode类,CSS 中定义该类下的全屏样式; - 调用
videoElement.requestFullscreen()需用户手势触发(如点击播放按钮),不能自动调用;所以“全屏”一般指视觉上铺满,而非原生全屏 API。
视频元素自身适配技巧
避免黑边或拉伸,关键在 object-fit 和宽高设置:
- 视频容器设为
position: relative; width: 100%; height: 100%;; - 视频标签设
width: 100%; height: 100%; object-fit: cover;(保持比例裁剪填充)或contain(完整显示留黑边); - 如需精准控制,可动态设置
video.style.height = window.innerHeight + 'px';,并在 resize 后重置。











