HTML5全屏(Fullscreen)API详细介绍

10/24/2015来源:HTML教程人气:940

  HTML5全屏(Fullscreen)API详细介绍

在越来越真实的web应用程序中,javaScript也变得越来越给力.

  FullScreen API 是一个新的Javascript API,简单而又强大. FullScreen 让我们可以通过编程的方式来向用户请求全屏显示,如果交互完成,随时可以退出全屏状态.

  在线演示Demo: Fullscreen API Example

  (在此Demo中,可以Launch ,Hide ,以及Dump显示相关属性,可以通过Chrome的控制台查看日志信息.)

  启动全屏模式

  全屏API requestFullscreen方法在一些老的浏览器里面依然使用带前缀形式的方法名,因此可能需要进行检测判断:

  (带前缀,意思就是各个浏览器内核不通用.)

  代码如下:

  // 找到支持的方法, 使用需要全屏的 element 调用

  function launchFullScreen(element) {

  if(element.requestFullscreen) {

  element.requestFullscreen();

  } else if(element.mozRequestFullScreen) {

  element.mozRequestFullScreen();

  } else if(element.webkitRequestFullscreen) {

  element.webkitRequestFullscreen();

  } else if(element.msRequestFullscreen) {

  element.msRequestFullscreen();

  }

  }

  // 在支持全屏的浏览器中启动全屏

  // 整个页面

  launchFullScreen(document.documentElement);

  // 某个元素

  launchFullScreen(document.getElementById("videoElement"));

  将需要全屏显示的DOM元素作为参数,调用此方法即可让window进入全屏状态,有时候可能需要用户同意(浏览器自己和用户交互),假若用户拒绝,则可能出现各种不完全的全屏.

  如果用户同意进入全屏,那么工具栏以及其他浏览器组件会隐藏起来,使document框架的宽度和高度横跨整个屏幕.

  退出全屏模式

  使用 exitFullscreen 方法可以使浏览器退出全屏,返回原先的布局. 该方法在一些老的浏览器上也是支持前缀方法.

  复制代码

  代码如下:

  // 退出 fullscreen

  function exitFullscreen() {

  if(document.exitFullscreen) {

  document.exitFullscreen();

  } else if(document.mozExitFullScreen) {

  document.mozExitFullScreen();

  } else if(document.webkitExitFullscreen) {

  document.webkitExitFullscreen();

  }

  }

  // 调用退出全屏方法!

  exitFullscreen();

  请注意: exitFullscreen 只能通过 document 对象调用 —— 而不是使用普通的 DOM element.

  Fullscreen 属性与事件

  一个坏消息,到目前为止,全屏事件和方法依然是带前缀的,好消息就是很快主流浏览器就会都支持。

  1.document.fullscreenElement: 当前处于全屏状态的元素 element.

  2.document.fullscreenEnabled: 标记 fullscreen 当前是否可用.

  当进入/退出 全屏模式时,会触发 fullscreenchange 事件:

  代码如下:

  var fullscreenElement =

  document.fullscreenEnabled

  || document.mozFullscreenElement

  || document.webkitFullscreenElement;

  var fullscreenEnabled =

  document.fullscreenEnabled

  || document.mozFullscreenEnabled

  || document.webkitFullscreenEnabled;

  在初始化全屏方法时,可以探测需要监听哪一个事件.

  Fullscreen CSS

  浏览器提供了一些有用的 fullscreen CSS 控制规则:

  复制代码

  代码如下:

  /* html */

  :-webkit-full-screen {

  /* PRoperties */

  }

  :-moz-fullscreen {

  /* properties */

  }

  :fullscreen {

  /* properties */

  }

  /* deeper elements */

  :-webkit-full-screen video {

  width: 100%;

  height: 100%;

  }

  /* styling the backdrop */

  ::backdrop {

  /* properties */

  }

  在某些情况下,WebKit需要一些特殊处理,所以在处理多媒体时,你可能需要上面的代码。

  我认为 Fullscreen API 超级简单,超级有用. 我首次见到这个 API 是在一个名为 MDN's BananaBread demo 的全客户端第一人称射击游戏, 这真是一个使用全屏模式的绝佳案例。

  全屏API提供了进入和退出全屏模式的方式,并提供相应的事件来监测全屏状态的改变,所以各方面都连贯起来了.

  请记住这个很好的API吧 —— 在未来的某个时刻,它肯定会派上用场!