Web全屏模式

MDN：全屏 API 为使用用户的整个屏幕展示网络内容提供了一种简单的方式。这种API让你能够简单地控制浏览器，使得一个元素与其子元素，若是存在的话，能够占据整个屏幕，并在此期间，从屏幕上隐藏全部的浏览器用户界面以及其余应用。

概览

• document.fullscreen
• document.fullscreenElement
• document.fullscreenEnabled
• elem.requestFullscreen
• document.exitFullscreen
• document.onfullscreenchange
• document.onfullscreenerror

属性

document.fullscreen

用于检测当前文档是否处于全屏模式，返回值为布尔类型

document.fullscreenElement

当前激活全屏模式的元素

document.fullscreenEnabled

当前文档是否支持全屏

方法

请求全屏模式

一个全屏的请求应该由一个具体的元素发出，以video元素为例，请求方式以下：

<video controls id="video">
  <source src="somevideo.webm"></source>
  <source src="somevideo.mp4"></source>
</video>
复制代码

var elem = document.getElementById("video");
elem.addEventListener('click',function () {
	if (elem.requestFullscreen) {
    elem.requestFullscreen();
  }
});
复制代码

MDN：全屏请求必须在事件处理函数中调用，不然将会被拒绝。

退出全屏模式

• 方式一：按 ESC 或 F11 键退出全屏
• 方式二：[keydown event] + document.exitFullscreen自定义全屏退出逻辑

// 按Enter建退出全屏
document.addEventListener("keydown", function(e) {
  if (e.keyCode == 13) {
    document.exitFullscreen();
  }
}, false);
复制代码

注意：exitFullscreen方法只存在于document对象上，而不存在与elem

事件

onfullscreenchange

onfullscreenchange事件触发的时刻的有2个：一是进入全屏时，二是退出全屏时。也就是说若是全屏模式的状态发生了改变，那么onfullscreenchange事件就会被触发

document.onfullscreenchange = function ( event ) {
  console.log("全屏模式状态改变");
};
复制代码

onfullscreenerror

当尝试在不支持全屏模式的元素上请求全屏时，则会发生错误，这个错误会触发onfullscreenerror事件

document.onfullscreenerror = function ( event ) { 
  console.log("全屏模式失败");
};
复制代码

验证onfullscreenerror事件最简单的方式就是：在事件监听器以外发起全屏请求。 由于**全屏请求必须在事件处理函数中调用，不然将会被拒绝。**在拒绝的同时会产生一个错误，这个错误会触发onfullscreenerror事件

document.onfullscreenerror = function ( event ) { 
  console.log("全屏模式失败");
}; 

// requestFullscreen()将会失败，由于它在事件处理器以外
document.documentElement.requestFullscreen();
复制代码

全屏样式

Gecko会自动为进入全屏模式的元素添加额外样式：width: 100%; height: 100%l; ，目的是使其铺满整个屏幕；而webkit没有这种默认行为，因此须要咱们手动补充这个样式

#video:-webkit-full-screen {
  width: 100%;
  height: 100%;
}
复制代码

兼容

PC端

移动端

前缀

表1

表2

结语

本文绝大部分参考MDN文档，目的是整理Web全屏Api，非原创文章

原文地址：www.guoyunfeng.com/2018/08/15/…