全螢幕展示在圖片檢視、簡報、影片播放與互動展示機上都很實用。瀏覽器提供了 Fullscreen API,但各家的函式名稱帶有前綴,所以實作時要做一次能力偵測,再挑一個能用的方法來呼叫。
先放一顆按鈕和一個要放大顯示的區塊:
<!DOCTYPE html>
<html>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<body>
<div style="margin:0 auto; height:600px; width:700px;">
<button id="btn">js 控制頁面的全螢幕展示與退出</button>
<div id="content" style="margin:0 auto; height:500px; width:700px; background:#ccc;">
<h1>js 控制頁面的全螢幕展示與退出</h1>
</div>
</div>
</body>
<script language="JavaScript">
document.getElementById("btn").onclick = function () {
var elem = document.getElementById("content");
requestFullScreen(elem);
};
function requestFullScreen(element) {
// 依序嘗試各瀏覽器的前綴版本
var requestMethod = element.requestFullScreen
|| element.webkitRequestFullScreen
|| element.mozRequestFullScreen
|| element.msRequestFullScreen;
if (requestMethod) {
requestMethod.call(element);
} else if (typeof window.ActiveXObject !== "undefined") {
// 老舊 IE 的退路:模擬按下 F11
var wscript = new ActiveXObject("WScript.Shell");
if (wscript !== null) {
wscript.SendKeys("{F11}");
}
}
}
</script>
標準寫法同樣需要處理前綴,與進入時對稱:
function exitFullScreen() {
var exitMethod = document.exitFullscreen
|| document.webkitExitFullscreen
|| document.mozExitFullscreen
|| document.msExitFullscreen;
if (exitMethod) {
exitMethod.call(document);
}
}
第一,全螢幕必須由使用者手勢觸發。如果在頁面載入時自動呼叫,瀏覽器會直接忽略,這是刻意的安全設計。
第二,進入全螢幕後建議監聽 fullscreenchange 事件來同步按鈕文案與圖示,讓「進入」與「退出」共用同一顆按鈕。事件名稱同樣有 webkit、moz、ms 前綴版本,記得一併綁定。
第三,全螢幕的其實是被指定的那個元素,而不是整個視窗。上面範例把 content 放進全螢幕,因此只有這個區塊會被放大,記得在 CSS 裡用 :fullscreen 或 :-webkit-full-screen 調整它的寬高,否則區塊不會自動填滿螢幕。
第四,程式裡那段以 ActiveX 模擬 F11 的寫法只在極老舊的 IE 上有效,而且會觸發安全性警告,現代專案可以直接淘汰,保留能力偵測的標準分支即可。