全屏模式通过Element.requestFullscreen()将页面或元素提升为顶层窗口,须由用户手势触发,退出时需清理资源并恢复布局。

全屏模式下用 Element.requestFullscreen() 触发显示
浏览器原生全屏 API 不是让某个 div “变大”,而是把整个页面(或指定元素)提升为顶层全屏窗口。直接调用 document.documentElement.requestFullscreen() 是最稳妥的起点,但要注意:必须由用户手势(如 click)触发,否则会被浏览器静默拒绝。
常见错误现象:requestFullscreen() failed: Document not focused 或控制台报 Failed to execute 'requestFullscreen' on 'Element': API can only be initiated by a user gesture——说明你试图在异步回调、定时器或非点击事件里调用它。
- 只在
button或div的onclick里调用,别封装进setTimeout或fetch成功回调 - Chrome/Firefox/Safari 对
requestFullscreen()支持良好,但旧版 Edge 需用msRequestFullscreen()兼容(现在基本可不考虑) - 全屏后地址栏、工具栏会隐藏,
document.fullscreenElement可用来判断当前是否处于全屏状态
标签页切换用 display: none/block 最简单可靠
大屏展示不需要 fancy 的动画库,CSS 控制显隐比 JS 操作 DOM 更轻量、更可控。每个标签页用独立 section 或 div 包裹,通过 class 切换 display 属性即可。
使用场景:展厅、监控大屏、会议汇报——这些场景对首屏加载速度和稳定性要求远高于动效流畅度。
立即学习“前端免费学习笔记(深入)”;
- 避免用
visibility: hidden,它仍占布局空间,可能影响全屏缩放比例 - 不要用
opacity: 0 + pointer-events: none模拟隐藏,键盘焦点和屏幕阅读器行为会出问题 - 切换时加一句
element.scrollIntoView({ behavior: 'smooth', block: 'start' }),防止内容被浏览器地址栏遮挡(尤其退出全屏后)
全屏 + 标签页组合时,注意 z-index 和 overflow
全屏后页面宽高变成视口尺寸,如果标签页容器设置了 overflow: auto,滚动条可能被全屏裁剪;如果用了绝对定位 + z-index,全屏状态下层级可能意外错乱。
性能影响:全屏本身不耗性能,但若每个标签页都包含大量 Canvas、Video 或 WebGl,切换时未及时暂停/卸载,会导致内存持续增长甚至卡顿。
- 全屏前主动调用
video.pause()、canvas.getContext('2d').clearRect()等清理逻辑 - 给最外层容器设
overflow: hidden,内部标签页用height: 100vh; width: 100vw填满,避免滚动条干扰 -
z-index值别硬写 9999,全屏后所有元素都在新 stacking context 下,用相对值(如 1 / 2 / 3)更安全
退出全屏后恢复原始布局的关键点
用户按 ESC 或调用 document.exitFullscreen() 后,页面不会自动“回弹”到原来状态——比如缩放比例、滚动位置、甚至标签页激活态都可能丢失。
容易踩的坑:监听 fullscreenchange 事件时,没区分进入还是退出,导致反复执行切换逻辑;或者在退出后没重置 body 的 padding / margin,造成页面突然偏移。
- 用
document.addEventListener('fullscreenchange', () => { if (!document.fullscreenElement) { /* 退出逻辑 */ } })显式判断 - 退出前缓存当前激活的标签页 ID(如
data-tab-id="chart"),退出后立即 restore - 如果用了
transform: scale()做适配,退出后记得重置为transform: none,否则页面看起来被压缩
全屏标签页看似简单,真正上线后出问题的几乎全是退出路径和资源清理——比如视频没停、Canvas 没清、滚动位置没记,这些问题在开发机上看不出来,一上大屏就暴露。



















