怎么让页面上的某块区域全屏展示?
参考答案
用 HTML5 全屏 API(Fullscreen API),只能对元素调用,且必须由用户手势触发,否则抛 NotAllowedError。
代码
const el = document.querySelector('#stage');
async function toggleFullscreen() {
if (!document.fullscreenElement) {
await el.requestFullscreen({ navigationUI: 'hide' }); // 旧版:webkitRequestFullscreen / msRequestFullscreen
} else {
await document.exitFullscreen();
}
}
btn.addEventListener('click', toggleFullscreen);
document.addEventListener('fullscreenchange', () => {
console.log(document.fullscreenElement); // 当前全屏的元素,null 表示已退出
});
document.addEventListener('fullscreenerror', console.error);
要点
- 判断状态用
document.fullscreenElement(旧版document.webkitFullscreenElement),不要自己维护布尔值。 - 全屏作用于元素本身,元素会自动铺满屏幕;样式可用
:fullscreen伪类微调(如改背景色、隐藏工具栏)。 - 键盘
Esc可退出,且无法被阻止;页面切换标签页一般会退出全屏。 - 嵌套全屏:对子元素再请求会形成「全屏元素栈」,退出时回到上一层。
- 浏览器级全屏受限时(如嵌入 iframe 需
allow="fullscreen")可以用 CSS 方案兜底:position: fixed; inset: 0; z-index: 9999;,但拿不到真正的沉浸效果。