全螢幕 API 的介面本身很簡單,真正麻煩的是各家瀏覽器都加了前綴。以下把啟動、退出、狀態查詢與樣式一次整理清楚。
對想要的元素呼叫請求方法即可,可以是整個網頁,也可以是某個影片容器:
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("video")); // 單一元素
呼叫後瀏覽器會先詢問使用者是否允許,使用者很可能拒絕。一旦進入全螢幕,工具列與選單都會隱藏,頁面覆蓋整個螢幕。
退出方法只能由 document 呼叫,而不是進全屏時傳入的那個元素:
function exitFullscreen() {
if (document.exitFullscreen) { document.exitFullscreen(); }
else if (document.mozCancelFullScreen) { document.mozCancelFullScreen(); }
else if (document.webkitExitFullscreen) { document.webkitExitFullscreen(); }
}
var fullscreenElement = document.fullscreenElement || document.mozFullScreenElement || document.webkitFullscreenElement; var fullscreenEnabled = document.fullscreenEnabled || document.mozFullScreenEnabled || document.webkitFullscreenEnabled;
fullscreenElement 回傳目前處於全螢幕的元素,fullscreenEnabled 則表示目前是否處於全螢幕狀態。fullscreenchange 事件會在進入或退出時觸發,同樣需要加上前綴才能跨瀏覽器監聽。
:fullscreen { /* properties */ }
:-webkit-full-screen { /* properties */ }
:-moz-full-screen { /* properties */ }
:-ms-fullscreen { /* properties */ }
:-webkit-full-screen video { width: 100%; height: 100%; }
::backdrop { /* properties */ }
WebKit 的實作在部分情境下會有非預期的樣式,建議把全螢幕樣式保持精簡,並用 backdrop 偽元素處理元素之外的背景。值得一提的是,這個 API 必須由使用者手勢觸發,因此不能-onload 自動進入全螢幕;這項限制無法繞過,設計互動時要把這點納入考量。