控制全螢幕的方式有好幾種,各家瀏覽器的 API 名稱也不統一。最通用的做法是依序探測各瀏覽器前綴,找到可用的方法後再呼叫。
function fullScreen() {
var el = document.documentElement;
var rfs = el.requestFullScreen ||
el.webkitRequestFullScreen ||
el.mozRequestFullScreen ||
el.msRequestFullScreen;
if (typeof rfs != "undefined" && rfs) {
rfs.call(el);
} else if (typeof window.ActiveXObject != "undefined") {
// 舊版 Internet Explorer 的退路
var wscript = new ActiveXObject("WScript.Shell");
if (wscript != null) {
wscript.SendKeys("{F11}");
}
}
}
標準 API 是 requestFullscreen(),但在標準化之前,各家用的是 webkitRequestFullScreen(Chrome/Safari)、mozRequestFullScreen(Firefox)與 msRequestFullScreen(舊 IE)。用「或」串接起來,就能取得當前環境下第一個可用的函式,再用 call(el) 把 this 綁回元素上。
至於 IE 的 ActiveXObject("WScript.Shell") 加 SendKeys("{F11}"),是模擬使用者按下 F11 的舊式做法,只在特定安全性設定下有效。
現在的瀏覽器已經普遍支援標準寫法,並搭配 Promise:
// 進入全螢幕
document.documentElement.requestFullscreen().catch(function (err) {
console.warn("無法進入全螢幕:", err);
});
// 離開全螢幕
document.exitFullscreen();
// 監聽狀態變化
document.addEventListener("fullscreenchange", function () {
console.log("全螢幕狀態:", !!document.fullscreenElement);
});
有兩件事值得留意:第一,瀏覽器要求全螢幕請求必須由使用者操作觸發(例如點擊),在頁面載入時自動呼叫會被拒絕;第二,若要同時鎖住鍵盤,需要額外申請 keyboardlock 權限,且僅在少數瀏覽器可用。