转自:http://blog.csdn.net/renfufei/article/details/17657093

翻译人员: 铁锚
原文日期: 2013年12月23日
翻译日期: 2013年12月29日
原文链接: Fullscreen API

在越来越真实的web应用程序中,JavaScript也变得越来越给力.
FullScreen API 是一个新的JavaScript API,简单而又强大. FullScreen 让我们可以通过编程的方式来向用户请求全屏显示,如果交互完成,随时可以退出全屏状态.
在线演示Demo:  Fullscreen API Example
(在此Demo中,可以Launch ,Hide ,以及Dump显示相关属性,可以通过chrome的控制台查看日志信息.)

启动全屏模式
全屏API requestFullscreen方法在一些老的浏览器里面依然使用带前缀形式的方法名,因此可能需要进行检测判断:
(带前缀,意思就是各个浏览器内核不通用.)

[javascript] view plaincopy在CODE上查看代码片派生到我的代码片
  1. // 找到支持的方法, 使用需要全屏的 element 调用  
  2. function launchFullScreen(element) {  
  3.   if(element.requestFullscreen) {  
  4.     element.requestFullscreen();  
  5.   } else if(element.mozRequestFullScreen) {  
  6.     element.mozRequestFullScreen();  
  7.   } else if(element.webkitRequestFullscreen) {  
  8.     element.webkitRequestFullscreen();  
  9.   } else if(element.msRequestFullscreen) {  
  10.     element.msRequestFullscreen();  
  11.   }  
  12. }  
  13.   
  14.   
  15. // 在支持全屏的浏览器中启动全屏  
  16. // 整个页面  
  17. launchFullScreen(document.documentElement);  
  18. // 某个元素  
  19. launchFullScreen(document.getElementById("videoElement"));  
将需要全屏显示的DOM元素作为参数,调用此方法即可让window进入全屏状态,有时候可能需要用户同意(浏览器自己和用户交互),假若用户拒绝,则可能出现各种不完全的全屏.
如果用户同意进入全屏,那么工具栏以及其他浏览器组件会隐藏起来,使document框架的宽度和高度横跨整个屏幕.

退出全屏模式
使用 exitFullscreen 方法可以使浏览器退出全屏,返回原先的布局. 该方法在一些老的浏览器上也是支持前缀方法.
[javascript] view plaincopy在CODE上查看代码片派生到我的代码片
  1. // 退出 fullscreen  
  2. function exitFullscreen() {  
  3.   if(document.exitFullscreen) {  
  4.     document.exitFullscreen();  
  5.   } else if(document.mozExitFullScreen) {  
  6.     document.mozExitFullScreen();  
  7.   } else if(document.webkitExitFullscreen) {  
  8.     document.webkitExitFullscreen();  
  9.   }  
  10. }  
  11.   
  12.   
  13. // 调用退出全屏方法!  
  14. exitFullscreen();  
请注意: exitFullscreen 只能通过 document 对象调用 —— 而不是使用普通的 DOM element.

Fullscreen 属性与事件
一个坏消息,到目前为止,全屏事件和方法依然是带前缀的,好消息就是很快主流浏览器就会都支持。
  • document.fullscreenElement:  当前处于全屏状态的元素 element.
  • document.fullscreenEnabled:  标记 fullscreen 当前是否可用.
当进入/退出 全屏模式时,会触发 fullscreenchange 事件:
[javascript] view plaincopy在CODE上查看代码片派生到我的代码片
  1. var fullscreenElement =   
  2.     document.fullscreenEnabled  
  3.     || document.mozFullscreenElement  
  4.     || document.webkitFullscreenElement;  
  5. var fullscreenEnabled =   
  6.     document.fullscreenEnabled  
  7.     || document.mozFullscreenEnabled  
  8.     || document.webkitFullscreenEnabled;  
在初始化全屏方法时,可以探测需要监听哪一个事件.

Fullscreen CSS
浏览器提供了一些有用的 fullscreen CSS 控制规则:
  1. /* html */  
  2. :-webkit-full-screen {  
  3.   /* properties */  
  4. }  
  5. :-moz-fullscreen {  
  6.   /* properties */  
  7. }  
  8.   
  9.   
  10. :fullscreen {  
  11.   /* properties */  
  12. }  
  13.   
  14.   
  15. /* deeper elements */  
  16. :-webkit-full-screen video {  
  17.   width100%;  
  18.   height100%;  
  19. }  
  20.   
  21.   
  22. /* styling the backdrop */  
  23. ::backdrop {  
  24.   /* properties */  
  25. }  
在某些情况下,WebKit需要一些特殊处理,所以在处理多媒体时,你可能需要上面的代码。

我认为 Fullscreen API 超级简单,超级有用. 我首次见到这个 API 是在一个名为 MDN's BananaBread demo 的全客户端第一人称射击游戏, 这真是一个使用全屏模式的绝佳案例。
全屏API提供了进入和退出全屏模式的方式,并提供相应的事件来监测全屏状态的改变,所以各方面都连贯起来了.

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



本文转载:CSDN博客