萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 控制網頁進入與退出全螢幕模式完整實作

Fullscreen API 標準流程

現代瀏覽器支援 Element.requestFullscreen()、document.exitFullscreen()、document.fullscreenElement、fullscreenchange 事件。舊版瀏覽器需加廠商前綴。

跨瀏覽器封裝函式

function requestFullScreen(element) {
    const req = element.requestFullscreen
        || element.webkitRequestFullscreen
        || element.mozRequestFullScreen
        || element.msRequestFullscreen;
    if (req) {
        req.call(element);
    } else if (typeof window.ActiveXObject !== 'undefined') {
        // 古老 IE 嘗試模擬 F11
        const wscript = new ActiveXObject('WScript.Shell');
        if (wscript) wscript.SendKeys('{F11}');
    }
}

function exitFullScreen() {
    const exit = document.exitFullscreen
        || document.webkitExitFullscreen
        || document.mozCancelFullScreen
        || document.msExitFullscreen;
    if (exit) exit.call(document);
}

完整可執行範例

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>全螢幕切換 Demo</title>
    <style>
        #content { width: 700px; height: 500px; background: #ccc; margin: 1rem auto; }
        .fullscreen { width: 100vw; height: 100vh; background: #fff; }
    </style>
</head>
<body>
    <button id="btn">切換全螢幕</button>
    <div id="content"><h1>內容區域</h1></div>

    <script>
        const btn = document.getElementById('btn');
        const content = document.getElementById('content');
        let isFull = false;

        btn.onclick = () => {
            if (!isFull) requestFullScreen(content);
            else exitFullScreen();
        };

        // 監聽瀏覽器原生全螢幕變化(使用者按 ESC、F11 等)
        document.addEventListener('fullscreenchange', syncState);
        document.addEventListener('webkitfullscreenchange', syncState);
        document.addEventListener('mozfullscreenchange', syncState);
        document.addEventListener('MSFullscreenChange', syncState);

        function syncState() {
            isFull = !!(document.fullscreenElement
                || document.webkitFullscreenElement
                || document.mozFullScreenElement
                || document.msFullscreenElement);
            btn.textContent = isFull ? '退出全螢幕' : '進入全螢幕';
        }
    </script>
</body>
</html>

常見坑點

  • 使用者互動必要:請求全螢幕必須在使用者手勢(click、keydown)的事件處理器中,否則會被拒絕並拋出 TypeError。
  • iframe 需加 allowfullscreen 屬性,內容才能請求全螢幕。
  • CSS :fullscreen / ::backdrop 可自訂全螢幕樣式與背景遮罩。

總結

封裝跨瀏覽器 requestFullScreen/exitFullScreen,配合 fullscreenchange 同步 UI 狀態,即可實作穩健的全螢幕切換功能。

copyright © 萬盛學電腦網 all rights reserved