JavaScript全屏功能依赖Fullscreen API,需用户手势触发;调用requestFullscreen()进入、exitFullscreen()退出;通过fullscreenElement判断状态;监听fullscreenchange事件响应变化,并需处理Promise拒绝。

JavaScript 实现全屏功能主要依靠浏览器提供的 Fullscreen API,它允许网页元素(如整个页面、视频、p 等)进入和退出全屏模式。注意:该操作必须由用户手势(如点击、按键)触发,不能自动执行,否则会被浏览器阻止。
如何进入全屏
调用目标元素的 requestFullscreen() 方法即可尝试进入全屏。现代浏览器基本支持,但需注意兼容性前缀(已基本淘汰,但可做兜底):
- 推荐写法(标准 + 兼容):
function launchFullscreen(element) {
if (element.requestFullscreen) {
element.requestFullscreen();
} else if (element.mozRequestFullScreen) { // Firefox
element.mozRequestFullScreen();
} else if (element.webkitRequestFullscreen) { // Chrome, Safari, Opera
element.webkitRequestFullscreen();
} else if (element.msRequestFullscreen) { // IE/Edge
element.msRequestFullscreen();
}
}
// 示例:让整个页面全屏
launchFullscreen(document.documentElement);
// 或让某个 p 全屏
// launchFullscreen(document.getElementById('myDiv'));
登录后复制
⚠️ 注意:document.documentElement 表示整个 HTML 文档(即“页面级”全屏),而传入某个 DOM 元素则只让该元素及其子内容占满屏幕(如播放器容器)。
如何退出全屏
调用 document.exitFullscreen() 即可退出当前全屏状态。同样需要兼容写法:
立即学习“Java免费学习笔记(深入)”;
function exitFullscreen() {
if (document.exitFullscreen) {
document.exitFullscreen();
} else if (document.mozCancelFullScreen) {
document.mozCancelFullScreen();
} else if (document.webkitExitFullscreen) {
document.webkitExitFullscreen();
} else if (document.msExitFullscreen) {
document.msExitFullscreen();
}
}
登录后复制
这个方法不接收参数,且无论哪个元素触发的全屏,都统一通过 document 退出。
如何判断是否处于全屏状态
可通过 document.fullscreenElement 判断:若为 null 表示未全屏;否则返回当前全屏的 DOM 元素。
标签: javascript java html 浏览器 edge safari
还木有评论哦,快来抢沙发吧~