当前位置：首页 > 文章列表 > 文章 > 前端 > JS监听全屏变化的5个事件详解

JS监听全屏变化的5个事件详解

2025-06-24 21:06:39 0浏览收藏

从现在开始，努力学习吧！本文《JS监听全屏状态变化的5个API事件详解》主要讲解了等等相关知识点，我会在golang学习网中持续更新相关的系列文章，欢迎大家关注并积极留言建议。下面就先一起来看一下本篇正文内容吧，希望能帮到你！

JS监听全屏状态变化主要通过fullscreenchange事件及浏览器前缀版本实现。1. 使用document.addEventListener('fullscreenchange', ...)监听标准事件；2. 添加mozfullscreenchange、webkitfullscreenchange、msfullscreenchange事件兼容Firefox、Chrome/Safari/Opera、IE/Edge浏览器；3. 通过封装requestFullscreen和exitFullscreen函数处理不同浏览器的API差异；4. 利用isFullscreen函数检测当前是否处于全屏模式，分别检查各浏览器对应的属性；5. 全屏样式调整可通过CSS媒体查询、JavaScript动态修改类名或CSS变量实现；6. 安全性方面需依赖用户交互触发全屏、提供退出方式、避免欺骗内容、使用HTTPS；7. 检测浏览器是否支持全屏API可通过判断document和element是否存在相关属性和方法。

JS怎么监听全屏状态变化 5个全屏API事件处理全屏切换

JS监听全屏状态变化，主要是通过监听浏览器提供的全屏API事件来实现。这允许你捕获用户进入或退出全屏模式的动作，并据此调整你的网页布局或执行其他相关操作。

// 监听全屏状态变化事件
document.addEventListener('fullscreenchange', function (event) {
  if (document.fullscreenElement) {
    // 进入全屏
    console.log('进入全屏模式');
  } else {
    // 退出全屏
    console.log('退出全屏模式');
  }
});

// 兼容不同浏览器的全屏事件
document.addEventListener('mozfullscreenchange', function (event) {
  // Firefox
  if (document.mozFullScreenElement) {
    console.log('进入 Firefox 全屏');
  } else {
    console.log('退出 Firefox 全屏');
  }
});

document.addEventListener('webkitfullscreenchange', function (event) {
  // Chrome, Safari, Opera
  if (document.webkitFullscreenElement) {
    console.log('进入 Webkit 全屏');
  } else {
    console.log('退出 Webkit 全屏');
  }
});

document.addEventListener('msfullscreenchange', function (event) {
  // IE, Edge
  if (document.msFullscreenElement) {
    console.log('进入 IE/Edge 全屏');
  } else {
    console.log('退出 IE/Edge 全屏');
  }
});

// 请求全屏的函数
function requestFullscreen(element) {
  if (element.requestFullscreen) {
    element.requestFullscreen();
  } else if (element.mozRequestFullScreen) {
    element.mozRequestFullScreen(); // Firefox
  } else if (element.webkitRequestFullscreen) {
    element.webkitRequestFullscreen(); // Chrome, Safari and Opera
  } else if (element.msRequestFullscreen) {
    element.msRequestFullscreen(); // IE/Edge
  }
}

// 退出全屏的函数
function exitFullscreen() {
  if (document.exitFullscreen) {
    document.exitFullscreen();
  } else if (document.mozCancelFullScreen) {
    document.mozCancelFullScreen(); // Firefox
  } else if (document.webkitExitFullscreen) {
    document.webkitExitFullscreen(); // Chrome, Safari and Opera
  } else if (document.msExitFullscreen) {
    document.msExitFullscreen(); // IE/Edge
  }
}

// 示例：点击按钮切换全屏
const button = document.getElementById('fullscreenButton');
button.addEventListener('click', function() {
  if (!document.fullscreenElement && !document.mozFullScreenElement && !document.webkitFullscreenElement && !document.msFullscreenElement) {
    requestFullscreen(document.documentElement); // 进入全屏
  } else {
    exitFullscreen(); // 退出全屏
  }
});

全屏API事件处理全屏切换，核心在于fullscreenchange事件以及各个浏览器前缀的版本（mozfullscreenchange、webkitfullscreenchange、msfullscreenchange）。

全屏API在不同浏览器中的兼容性问题怎么解决？

要解决全屏API在不同浏览器中的兼容性问题，核心在于编写兼容性代码，检测并使用正确的API方法。因为不同浏览器对全屏API的实现方式略有不同，主要体现在方法名称和属性名称上。

检测浏览器前缀： 针对不同的浏览器，可能需要使用不同的前缀，如moz（Firefox）、webkit（Chrome、Safari）、ms（IE/Edge）。
封装全屏函数： 创建一个函数来处理进入和退出全屏的逻辑，函数内部检测浏览器类型并调用相应的API。
使用统一的事件监听： 监听各种带有浏览器前缀的fullscreenchange事件，确保在任何浏览器中都能捕获全屏状态的变化。

以下是一个更完善的示例，展示了如何处理全屏请求和退出，并考虑到不同浏览器的兼容性：

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

function requestFullscreen(element) {
    if (element.requestFullscreen) {
        element.requestFullscreen();
    } else if (element.mozRequestFullScreen) {
        element.mozRequestFullScreen();
    } else if (element.webkitRequestFullscreen) {
        element.webkitRequestFullscreen();
    } else if (element.msRequestFullscreen) {
        element.msRequestFullscreen();
    }
}

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();
    }
}

function toggleFullscreen(element) {
    if (isFullscreen()) {
        exitFullscreen();
    } else {
        requestFullscreen(element || document.documentElement); // 默认全屏整个文档
    }
}

// 监听全屏状态变化
document.addEventListener('fullscreenchange', function (event) {
    console.log('Fullscreen changed (generic)');
});
document.addEventListener('mozfullscreenchange', function (event) {
    console.log('Fullscreen changed (Mozilla)');
});
document.addEventListener('webkitfullscreenchange', function (event) {
    console.log('Fullscreen changed (Webkit)');
});
document.addEventListener('msfullscreenchange', function (event) {
    console.log('Fullscreen changed (MS)');
});

// 使用示例
const fullscreenButton = document.getElementById('fullscreenButton');
fullscreenButton.addEventListener('click', function() {
    toggleFullscreen(document.documentElement);
});

如何检测当前是否处于全屏模式？

检测当前是否处于全屏模式，需要检查浏览器提供的不同属性，这些属性指示了当前文档或元素是否正在全屏显示。与请求全屏类似，不同的浏览器使用不同的属性。

以下代码展示了如何跨浏览器检测全屏状态：

function isFullscreen() {
  return document.fullscreenElement ||
         document.mozFullScreenElement ||
         document.webkitFullscreenElement ||
         document.msFullscreenElement ||
         false; // 如果以上属性都不存在，则返回 false
}

// 使用示例
if (isFullscreen()) {
  console.log('当前处于全屏模式');
} else {
  console.log('当前不是全屏模式');
}

这段代码定义了一个isFullscreen函数，它会检查以下属性：

document.fullscreenElement: W3C标准属性，现代浏览器支持。
document.mozFullScreenElement: Firefox浏览器使用的属性。
document.webkitFullscreenElement: Chrome、Safari和Opera浏览器使用的属性。
document.msFullscreenElement: IE和Edge浏览器使用的属性。

如果其中任何一个属性返回一个元素（即，一个元素正在全屏显示），则该函数返回true，表示当前处于全屏模式。否则，返回false。

全屏模式下的样式调整技巧

在全屏模式下，可能需要对页面样式进行调整，以适应更大的屏幕空间或提供更好的用户体验。可以使用CSS和JavaScript来实现这些调整。

CSS媒体查询： 可以使用CSS媒体查询来检测全屏状态，并应用相应的样式。但是，这种方法依赖于浏览器是否正确地报告全屏状态，并且可能不够可靠。

/* 全屏模式下的样式 */
@media (display-mode: fullscreen) {
  body {
    font-size: 1.2em; /* 增大字体 */
    /* 其他样式调整 */
  }
}

JavaScript动态调整样式： 使用JavaScript监听全屏状态变化事件，并在进入或退出全屏时动态地修改元素的样式。这种方法更加灵活和可靠。

document.addEventListener('fullscreenchange', function() {
  if (isFullscreen()) {
    // 进入全屏模式
    document.body.classList.add('fullscreen-mode');
  } else {
    // 退出全屏模式
    document.body.classList.remove('fullscreen-mode');
  }
});

然后，在CSS中定义.fullscreen-mode类的样式：

.fullscreen-mode {
  font-size: 1.2em; /* 增大字体 */
  /* 其他样式调整 */
}

使用CSS变量： 结合JavaScript和CSS变量，可以更方便地控制全屏模式下的样式。

document.addEventListener('fullscreenchange', function() {
  if (isFullscreen()) {
    document.documentElement.style.setProperty('--fullscreen-font-size', '1.2em');
  } else {
    document.documentElement.style.setProperty('--fullscreen-font-size', '1em');
  }
});

然后在CSS中使用CSS变量：

body {
  font-size: var(--fullscreen-font-size, 1em); /* 默认字体大小为 1em */
}

全屏API的安全性考虑，如何避免恶意全屏？

全屏API的安全性主要涉及避免恶意网站滥用全屏功能，例如，强制用户进入全屏模式，并在全屏模式下显示欺骗性内容。为了防止这种情况，浏览器通常会采取以下措施：

用户许可： 浏览器通常要求用户明确许可才能进入全屏模式。例如，只有在用户点击了页面上的某个元素后，才能调用requestFullscreen方法。未经用户交互，无法自动进入全屏模式。
全屏指示器： 浏览器通常会在全屏模式下显示一个指示器（例如，一个小的图标或消息），告知用户当前页面处于全屏状态。这可以帮助用户识别恶意全屏，并及时退出。
键盘快捷键： 浏览器通常提供一个键盘快捷键（例如，Esc键），允许用户随时退出全屏模式。
权限策略（Permissions Policy）： 现代浏览器支持使用权限策略来控制全屏API的使用。通过设置fullscreen策略，可以限制哪些域或iframe可以请求全屏。

以下是一些建议，可以帮助开发者在使用全屏API时遵守安全最佳实践：

仅在必要时使用全屏： 避免不必要地使用全屏功能。只有在用户明确需要全屏体验时，才应该请求全屏。
提供清晰的退出全屏方式： 确保用户可以轻松地退出全屏模式。可以在全屏模式下显示一个“退出全屏”按钮，或者告知用户可以使用Esc键退出。
避免在全屏模式下显示欺骗性内容： 确保在全屏模式下显示的内容是真实和可信的。避免使用欺骗性的标题、图标或消息，以免误导用户。
使用HTTPS： 确保网站使用HTTPS协议，以防止中间人攻击。中间人攻击者可能会篡改页面内容，并在全屏模式下显示恶意内容。

JS如何判断当前浏览器是否支持全屏API？

要判断当前浏览器是否支持全屏API，可以通过检查document对象和Element.prototype对象上是否存在相关的属性和方法。由于不同浏览器可能使用不同的前缀，因此需要检查多个属性和方法。

以下是一个示例函数，可以用来检测全屏API的支持情况：

function isFullscreenAPISupported() {
  return (
    'fullscreenEnabled' in document ||
    'mozFullScreenEnabled' in document ||
    'webkitFullscreenEnabled' in document ||
    'msFullscreenEnabled' in document &&
    'requestFullscreen' in document.documentElement ||
    'mozRequestFullScreen' in document.documentElement ||
    'webkitRequestFullscreen' in document.documentElement ||
    'msRequestFullscreen' in document.documentElement
  );
}

// 使用示例
if (isFullscreenAPISupported()) {
  console.log('当前浏览器支持全屏API');
} else {
  console.log('当前浏览器不支持全屏API');
}

这个函数检查了以下属性和方法：

document.fullscreenEnabled、document.mozFullScreenEnabled、document.webkitFullscreenEnabled、document.msFullscreenEnabled: 这些属性指示浏览器是否允许全屏模式。
document.documentElement.requestFullscreen、document.documentElement.mozRequestFullScreen、document.documentElement.webkitRequestFullscreen、document.documentElement.msRequestFullscreen: 这些方法用于请求全屏模式。

如果以上任何一个属性或方法存在，则该函数返回true，表示当前浏览器支持全屏API。否则，返回false。

本篇关于《JS监听全屏变化的5个事件详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！

全屏状态 API事件