欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

HTML5 全屏 API

程序员文章站 2022-08-10 20:57:10
翻译人员: 铁锚 原文日期: 2013年12月23日 翻译日期: 2013年12月29日 原文链接: fullscreen api 在越来越真实的web应用程序中,javascript也变得越来越...
翻译人员: 铁锚
原文日期: 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方法在一些老的里面依然使用带前缀形式的方法名,因此可能需要进行检测判断:
(带前缀,意思就是各个浏览器内核不通用.)
// 找到支持的方法, 使用需要全屏的 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 属性与事件
一个坏消息,到目前为止,全屏事件和方法依然是带前缀的,好消息就是很快主流浏览器就会都支持。
document.fullscreenelement: 当前处于全屏状态的元素 element.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吧 —— 在未来的某个时刻,它肯定会派上用场!