首页 > 文章 > 前端

JavaScript实现全屏功能，如何进入和退出全屏？

时间：2026-01-22 22:18:35 217浏览收藏

哈喽！大家好，很高兴又见面了，我是golang学习网的一名作者，今天由我给大家带来一篇《JavaScript实现全屏功能，如何进入和退出全屏？》，本文主要会讲到等等知识点，希望大家一起学习进步，也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧！

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

Javascript如何实现全屏功能_如何进入和退出全屏？

JavaScript 实现全屏功能主要依靠浏览器提供的 Fullscreen API，它允许网页元素（如整个页面、视频、div 等）进入和退出全屏模式。注意：该操作必须由用户手势（如点击、按键）触发，不能自动执行，否则会被浏览器阻止。

如何进入全屏

调用目标元素的 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);

// 或让某个 div 全屏
// launchFullscreen(document.getElementById('myDiv'));

⚠️ 注意：document.documentElement 表示整个 HTML 文档（即“页面级”全屏），而传入某个 DOM 元素则只让该元素及其子内容占满屏幕（如播放器容器）。

如何退出全屏

调用 document.exitFullscreen() 即可退出当前全屏状态。同样需要兼容写法：

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 元素。

document.fullscreenElement —— 当前全屏的元素（标准）
兼容属性：document.mozFullScreenElement、document.webkitFullscreenElement、document.msFullscreenElement

常用判断逻辑：

function isFullscreen() {
  return !!(
    document.fullscreenElement ||
    document.webkitFullscreenElement ||
    document.mozFullScreenElement ||
    document.msFullscreenElement
  );
}

监听全屏状态变化

全屏进入/退出时会触发事件，可用于更新 UI（如切换按钮图标）：

fullscreenchange：标准事件（推荐监听）
兼容事件：webkitfullscreenchange、mozfullscreenchange、msfullscreenchange

示例：

document.addEventListener('fullscreenchange', () => {
  if (isFullscreen()) {
    console.log('已进入全屏');
    // 更新按钮文字为“退出全屏”
  } else {
    console.log('已退出全屏');
    // 更新按钮文字为“进入全屏”
  }
});

注意：事件绑定在 document 上，不是触发元素上。

不复杂但容易忽略：全屏 API 是异步的，可能失败（比如没用户交互、跨 iframe 限制、移动端不支持等），建议配合 catch 处理 Promise 拒绝（现代 requestFullscreen() 返回 Promise）：

element.requestFullscreen()
  .catch(err => console.error('无法进入全屏:', err));

理论要掌握，实操不能落！以上关于《JavaScript实现全屏功能，如何进入和退出全屏？》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！

前往漫画官网入口并下载 ➜