Web 應用越做越像真正的應用程式,JavaScript 的能力也跟著水漲船高。FullScreen API 就是一個小而美的例子:它讓你能以程式方式向使用者請求全螢幕顯示,並隨時退出。
requestFullscreen 是每個元素都有的方法,但各家瀏覽器前綴不同,因此需要一層探測:
// 找出可用的方法並呼叫
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 元素當參數傳入即可。有兩點要留意:這個呼叫必須在使用者互動(如點擊)的同步呼叫堆疊中執行;而且部分瀏覽器會跳出確認提示,若使用者拒絕,就會得到一個「不完全的全螢幕」狀態。
使用者同意後,工具列與其他瀏覽器元件會隱藏起來,document 的寬高會橫跨整個螢幕。
function exitFullscreen() {
if (document.exitFullscreen) {
document.exitFullscreen();
} else if (document.mozExitFullScreen) {
document.mozExitFullScreen();
} else if (document.webkitExitFullscreen) {
document.webkitExitFullscreen();
}
}
exitFullscreen();
關鍵差異:exitFullscreen 只能透過 document 物件呼叫,而不是任何 DOM 元素。這點很容易寫錯。
壞消息是這些到目前為止仍帶前綴,好消息是主流瀏覽器很快就會統一。兩個要用的屬性:
document.fullscreenElement:目前處於全螢幕狀態的元素。document.fullscreenEnabled:全螢幕功能目前是否可用。 var fullscreenElement =
document.fullscreenElement ||
document.mozFullscreenElement ||
document.webkitFullscreenElement;
var fullscreenEnabled =
document.fullscreenEnabled ||
document.mozFullscreenEnabled ||
document.webkitFullscreenEnabled;
進入與退出全螢幕時會觸發 fullscreenchange 事件。實務上的建議做法是在初始化時就探測該監聽哪一個事件名稱(含前綴),註冊對應的那一個。
瀏覽器提供了幾個全螢幕狀態的樣式選擇器,讓你能針對全螢幕下的元素單獨調整樣式:
/* 全螢幕的元素本身 */
:-webkit-full-screen { /* properties */ }
:-moz-fullscreen { /* properties */ }
:fullscreen { /* properties */ }
/* 其內部的子元素 */
:-webkit-full-screen video {
width: 100%;
height: 100%;
}
/* 全螢幕的背光層 */
::backdrop { /* properties */ }
WebKit 在處理多媒體時有時需要額外的特殊規則,這也是為什麼上面那段 video 的樣式要單獨寫一次。
Fullscreen API 簡單、實用,而且概念上很完整:進入、退出、狀態查詢、事件通知,一應俱全。我第一次看到這個 API 是在 MDN 的 BananaBread demo——一個純客戶端的第一人稱射擊遊戲,那是全螢幕模式最理想的應用場景。記住它,未來某個時刻一定會派上用場。