首页 > 文章 > 前端

JavaScript全屏切换实现方法

时间：2026-01-07 08:45:43 335浏览收藏

今天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学习网公众号，带你了解更多关于的知识点！

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