HTML5全屏(Fullscreen)API詳細(xì)介紹

發(fā)布時(shí)間：2015-04-24 15:49:31 作者：佚名

這篇文章主要介紹了HTML5全屏(Fullscreen)API詳細(xì)介紹,本文給出了啟動(dòng)全屏模式和退出全屏模式代碼示例,同時(shí)講解了Fullscreen 屬性與事件,需要的朋友可以參考下

在越來(lái)越真實(shí)的web應(yīng)用程序中,JavaScript也變得越來(lái)越給力.

FullScreen API 是一個(gè)新的JavaScript API,簡(jiǎn)單而又強(qiáng)大. FullScreen 讓我們可以通過(guò)編程的方式來(lái)向用戶(hù)請(qǐng)求全屏顯示,如果交互完成,隨時(shí)可以退出全屏狀態(tài).

在線(xiàn)演示Demo: Fullscreen API Example

(在此Demo中，可以L(fǎng)aunch ,Hide ,以及Dump顯示相關(guān)屬性,可以通過(guò)chrome的控制臺(tái)查看日志信息.)

啟動(dòng)全屏模式

全屏API requestFullscreen方法在一些老的瀏覽器里面依然使用帶前綴形式的方法名,因此可能需要進(jìn)行檢測(cè)判斷:
(帶前綴,意思就是各個(gè)瀏覽器內(nèi)核不通用.)

復(fù)制代碼

代碼如下:

// 找到支持的方法, 使用需要全屏的 element 調(diào)用
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();
}
}

// 在支持全屏的瀏覽器中啟動(dòng)全屏
// 整個(gè)頁(yè)面
launchFullScreen(document.documentElement);
// 某個(gè)元素
launchFullScreen(document.getElementById("videoElement"));

將需要全屏顯示的DOM元素作為參數(shù),調(diào)用此方法即可讓window進(jìn)入全屏狀態(tài),有時(shí)候可能需要用戶(hù)同意(瀏覽器自己和用戶(hù)交互),假若用戶(hù)拒絕,則可能出現(xiàn)各種不完全的全屏.

如果用戶(hù)同意進(jìn)入全屏,那么工具欄以及其他瀏覽器組件會(huì)隱藏起來(lái),使document框架的寬度和高度橫跨整個(gè)屏幕.

退出全屏模式

使用 exitFullscreen 方法可以使瀏覽器退出全屏,返回原先的布局. 該方法在一些老的瀏覽器上也是支持前綴方法.

復(fù)制代碼

代碼如下:

// 退出 fullscreen
function exitFullscreen() {
if(document.exitFullscreen) {
document.exitFullscreen();
} else if(document.mozExitFullScreen) {
document.mozExitFullScreen();
} else if(document.webkitExitFullscreen) {
document.webkitExitFullscreen();
}
}

// 調(diào)用退出全屏方法!
exitFullscreen();

請(qǐng)注意: exitFullscreen 只能通過(guò) document 對(duì)象調(diào)用 —— 而不是使用普通的 DOM element.

Fullscreen 屬性與事件

一個(gè)壞消息,到目前為止,全屏事件和方法依然是帶前綴的,好消息就是很快主流瀏覽器就會(huì)都支持。

1.document.fullscreenElement: 當(dāng)前處于全屏狀態(tài)的元素 element.
2.document.fullscreenEnabled: 標(biāo)記 fullscreen 當(dāng)前是否可用.

當(dāng)進(jìn)入/退出全屏模式時(shí),會(huì)觸發(fā) fullscreenchange 事件:

復(fù)制代碼

代碼如下:

var fullscreenElement =
document.fullscreenEnabled
|| document.mozFullscreenElement
|| document.webkitFullscreenElement;
var fullscreenEnabled =
document.fullscreenEnabled
|| document.mozFullscreenEnabled
|| document.webkitFullscreenEnabled;

在初始化全屏方法時(shí),可以探測(cè)需要監(jiān)聽(tīng)哪一個(gè)事件.

Fullscreen CSS

瀏覽器提供了一些有用的 fullscreen CSS 控制規(guī)則:

復(fù)制代碼

代碼如下:

/* 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需要一些特殊處理,所以在處理多媒體時(shí),你可能需要上面的代碼。

我認(rèn)為 Fullscreen API 超級(jí)簡(jiǎn)單,超級(jí)有用. 我首次見(jiàn)到這個(gè) API 是在一個(gè)名為的全客戶(hù)端第一人稱(chēng)射擊游戲, 這真是一個(gè)使用全屏模式的絕佳案例。

全屏API提供了進(jìn)入和退出全屏模式的方式,并提供相應(yīng)的事件來(lái)監(jiān)測(cè)全屏狀態(tài)的改變,所以各方面都連貫起來(lái)了.

請(qǐng)記住這個(gè)很好的API吧 —— 在未來(lái)的某個(gè)時(shí)刻,它肯定會(huì)派上用場(chǎng)!