Web 應用越做越像真正的應用程式,JavaScript 的能力也跟著水漲船高。Fullscreen API 就是一個小而美的例子:它讓你可以透過程式向使用者請求全螢幕顯示,互動結束後再隨時退出。
最典型的應用場景是媒體播放、遊戲、簡報與圖表儀表板——凡是「使用者需要專注」的地方,把瀏覽器介面隱藏起來都有明顯價值。
要特別注意:這個 API 的各家 prefix 差異比一般 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("videoElement"));
把目標 DOM 元素當參數傳入即可。成功之後,工具列與其他瀏覽器元件會隱藏起來,document 框架的寬高會橫跨整個螢幕。
值得注意的是,全螢幕請求通常需要使用者手勢觸發(例如綁在 click 事件上)。若在頁面載入時自動呼叫,多數瀏覽器會直接忽略;若使用者拒絕,則可能出現各種「不完全的全螢幕」狀態。
function exitFullscreen() {
if (document.exitFullscreen) {
document.exitFullscreen();
} else if (document.mozExitFullScreen) {
document.mozExitFullScreen();
} else if (document.webkitExitFullscreen) {
document.webkitExitFullscreen();
}
}
// 呼叫退出
exitFullscreen();
這裡有個容易寫錯的地方:exitFullscreen 只能透過 document 物件呼叫,而不是用普通的 DOM 元素。進入時是「某個元素請求」,退出時則是「整個文件退出」,兩者的呼叫主體不同。
Fullscreen 相關的屬性與事件目前同樣帶有 prefix,好消息是主流瀏覽器已大致完成標準化。兩個核心屬性:
document.fullscreenElement:當前處於全螢幕狀態的元素。若為 null,代表目前沒有全螢幕。document.fullscreenEnabled:標記 Fullscreen 功能目前是否可用。相容寫法:
var fullscreenElement = document.fullscreenElement
|| document.mozFullscreenElement
|| document.webkitFullscreenElement;
var fullscreenEnabled = document.fullscreenEnabled
|| document.mozFullscreenEnabled
|| document.webkitFullscreenEnabled;
進入或退出全螢幕時,會觸發 fullscreenchange 事件。實作上建議在初始化階段先探測該監聽哪一個事件名稱:
var fsChange = document.onfullscreenchange ? 'fullscreenchange'
: document.onmozfullscreenchange ? 'mozfullscreenchange'
: document.onwebkitfullscreenchange ? 'webkitfullscreenchange'
: null;
if (fsChange) {
document.addEventListener(fsChange, function () {
var isFull = !!(document.fullscreenElement
|| document.mozFullscreenElement
|| document.webkitFullscreenElement);
console.log('全螢幕狀態:', isFull);
});
}
瀏覽器也提供了 fullscreenerror 事件,用來捕捉請求失敗的情況(例如缺少使用者手勢、或權限被拒),建議一併監聽,避免使用者按了卻毫無反應。
瀏覽器提供了一些專用的 CSS 規則供你調整全螢幕下的樣式:
/* html 元素本身 */
:-webkit-full-screen {
/* properties */
}
:-moz-fullscreen {
/* properties */
}
:fullscreen {
/* properties */
}
/* 全螢幕下的深層元素 */
:-webkit-full-screen video {
width: 100%;
height: 100%;
}
/* 樣式化背景墊層 */
::backdrop {
/* properties */
}
其中 WebKit 需要額外處理的情況比較多,處理多媒體時經常需要用到上面那段 video 的規則,否則影片在全螢幕下可能不會填滿整個畫面。::backdrop 則是用來樣式化元素背後那層覆蓋的底色。
第一,別忘了 iOS Safari。iPhone 上的 Safari 對 Fullscreen API 支援我向來保守,<video> 有自己專用的 webkitEnterFullscreen(),而一般元素的全螢幕在 iPhone 上長期不可用。如果你的目標使用者包含 iOS,一定要準備好替代方案。
第二,記得處理 resize。進入與退出全螢幕會改變可用空間,任何依賴尺寸計算的版面(canvas、圖表、地圖)都應該在 fullscreenchange 裡重新量測並重繪。
第三,一定要提供明顯的退出入口。除了 Esc 鍵,畫面上最好有一個可見的關閉按鈕,行動裝置尤其如此。
整體來說,Fullscreen API 簡單、實用、沒有學習門檻。MDN 那個名為 BananaBread 的全客戶端第一人稱射擊遊戲,就是一個把全螢幕用在其刀刃上的絕佳案例——值得記住這個 API,總有一天會派上用場。