全屏API必须由用户手势触发,移动端需降级处理;CSS需重置根节点样式并用flex/grid布局;图表须在全屏回调中resize;跨窗口通信应改用BroadcastChannel。

全屏 API 调用必须加用户手势触发
直接在页面加载时执行 document.documentElement.requestFullscreen() 会被浏览器静默拒绝,控制台报错 Failed to execute 'requestFullscreen' on 'Element': API can only be initiated by a user gesture.。这是硬性安全策略,不是兼容性问题。
实操建议:
- 把全屏入口做成显眼按钮,比如
,绑定click事件 - 不要用
setTimeout模拟点击或自动触发——无效,且破坏可访问性 - 移动端 Safari 对
requestFullscreen()支持极差,iOS 16+ 才部分支持,优先降级为screen.orientation.lock('landscape')+ viewport 缩放 - 退出全屏后,
document.onfullscreenchange事件里记得恢复 body overflow 和 zoom,否则页面可能被锁死
CSS 全屏适配别只靠 width/height: 100%
width: 100%; height: 100%; 在嵌套容器中极易失效,尤其当父元素没设高度或用了 flex/grid 布局时,子元素会塌缩成 0px。真正在大屏上“撑满”,得从根节点开始控制。
实操建议:
- 重置基础样式:
html, body { margin: 0; padding: 0; height: 100%; overflow: hidden; } - 容器用
display: grid或display: flex,主区域设flex: 1或grid-area: main,避免依赖百分比高度继承 - 关键指标字体用
clamp(24px, 6vw, 80px),禁用纯vw(1080p 下数字太小)和固定px(4K 下糊成一片) - 背景图用
background-size: cover; background-position: center;,别用100% 100%拉伸变形
Canvas/ECharts 容器必须等 DOM 稳定再 resize
仪表盘里 Canvas 图表(如转速表、环形电量)或 ECharts 实例,在全屏切换瞬间如果还没初始化完,或容器尺寸为 0,会导致渲染空白、坐标错乱、指针偏移。这不是数据问题,是时机问题。
实操建议:
- 全屏成功回调里,先调
chart.resize()或canvas.width = canvas.parentElement.clientWidth,再chart.setOption() - 别在
DOMContentLoaded就初始化图表——此时 DOM 可能还没挂载到视口,尺寸取不到;改用requestAnimationFrame延迟一帧 - 监听
window.onresize时加节流,防高频触发;但全屏切换必须立即响应,不能节流 - Canvas 渲染前务必
ctx.clearRect(0, 0, canvas.width, canvas.height),否则旧帧残留叠加
多屏展示时 sessionStorage 同步状态容易丢帧
7 屏仪表 APP 那种场景下,用 sessionStorage 广播当前 tab 索引,多个窗口靠监听 storage 事件同步,看似简单,实际在高刷屏(120Hz)上会明显卡顿。因为 storage 事件是宏任务,无法对齐 requestAnimationFrame 的 16ms 帧周期。
实操建议:
- 跨窗口通信改用
BroadcastChannelAPI,它基于微任务队列,延迟更低,且支持任意序列化数据 - 不要在 storage/broadcast 回调里直接操作 DOM 或重绘图表——先存入本地状态,再用
requestAnimationFrame统一更新 - 7 屏轮播若用定时器,禁用
setInterval;改用setTimeout链式调用,确保上一屏动画结束才启动下一屏 - 轮播间隔别设死值(如 5000ms),根据每屏内容复杂度动态计算:Canvas 绘制耗时 + 数据 fetch 时间 + 动画 duration
全屏最麻烦的从来不是“怎么撑满”,而是“撑满之后,每一帧都得稳住”。Canvas 坐标系、ECharts 容器尺寸、字体缩放锚点、跨窗口状态同步节奏——这些点只要一个没对齐,大屏就变成幻灯片卡顿现场。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











