「打開頁面就全屏」這個需求在早年很常見,尤其用於 kiosk 展示、企業內部的數據大屏。當年的實現方式今天看來相當原始,值得回顧一下它是怎麼演進的。
<script language="javaScript">
function intro() {
if ((navigator.appVersion.indexOf("Mac") != -1)
&& (navigator.userAgent.indexOf("MSIE") != -1)
&& (parseInt(navigator.appVersion) == 4)) {
skip();
} else {
popup();
}
}
function skip() { location.href = "https://"; }
function popup() {
var version = parseFloat(navigator.appVersion.substring(
navigator.appVersion.indexOf('.') - 1, navigator.appVersion.length));
if (version >= 4) {
if (navigator.appName == "Netscape") {
var Hello = window.open("https://", "Hello", "scrollbars");
Hello.focus();
}
if (navigator.appName == "Microsoft Internet Explorer") {
window.open("https://", "screen", "fullscreen=yes");
}
} else {
location.href = "https://";
}
}
</script>
<BODY onload="intro()"></BODY>
這段代碼做了幾件事:用 navigator.appVersion 和 navigator.appName 嗅探瀏覽器及版本;對 IE 通過 window.open 的第三個參數傳 fullscreen=yes 打開全屏窗口;對 Netscape 只能退而求其次打開一個帶滾動條的普通窗口。
它為什麼現在完全不能用?navigator.appName 早就失真(Chrome、Firefox 為了兼容都會謊報成 Netscape);appVersion 的格式也早已不是當年那樣;而 window.open 的 fullscreen 特性被瀏覽器廢棄了,出於安全考慮不允許腳本擅自讓窗口全屏。瀏覽器嗅探這條路本身就是死路——特徵檢測才是正解。
今天的標準做法如下。注意有兩個關鍵限制:必須在用戶手勢(點擊、按鍵)中調用,以及需要加瀏覽器前綴來兼容不同實現。
function enterFullscreen(el) {
var request = el.requestFullscreen
|| el.webkitRequestFullscreen
|| el.mozRequestFullScreen
|| el.msRequestFullscreen;
if (request) {
request.call(el);
}
}
function exitFullscreen() {
var exit = document.exitFullscreen
|| document.webkitExitFullscreen
|| document.mozCancelFullScreen
|| document.msExitFullscreen;
if (exit) {
exit.call(document);
}
}
// 必須綁在用戶交互上,頁面加載時自動調用會被拒絕
document.getElementById('btnFull').addEventListener('click', function () {
enterFullscreen(document.documentElement);
});
監聽全屏狀態變化,以便同步更新按鈕文案:
document.addEventListener('fullscreenchange', function () {
var isFull = !!document.fullscreenElement;
document.getElementById('btnFull').textContent = isFull ? '退出全屏' : '全屏';
});
// 兼容寫法
document.addEventListener('webkitfullscreenchange', onChange);
document.addEventListener('mozfullscreenchange', onChange);
document.addEventListener('MSFullscreenChange', onChange);
可以只讓某個元素全屏。傳 document.documentElement 是整頁全屏,傳某個 div 則只放大那個元素——數據大屏、視頻播放器通常採用後者,這樣全屏時不會看到瀏覽器之外的任何內容。
全屏元素會脫離正常文檔流。進入全屏後,該元素會被提到一個特殊的頂層,其餘內容不可見。因此全屏元素應該是一個包含完整內容的容器,而不是頁面裡的某個小片段。
ESC 鍵可以退出全屏,這無法攔截。出於用戶控制權的考慮,瀏覽器保留這個逃生通道,別試著阻止。
iframe 需要授權。如果頁面嵌在 iframe 裡,父層需要設置 allow="fullscreen" 屬性,否則全屏請求會被拒絕並在控制台報錯。
iOS Safari 是例外。iPhone 上的 Safari 長期不支持元素全屏(視頻播放除外),需要准備降級方案,比如用 CSS 模擬全屏效果。
總結:全屏現在是一個需要用戶主動觸發、隨時可以按 ESC 退出的功能,而不是可以自動生效的頁面屬性。這正是從「站點可以隨意控制瀏覽器」到「用戶掌握最終控制權」的觀念轉變。