萬盛學電腦網

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

JavaScript 控制瀏覽器全螢幕模式完整指南

前言

現代網頁應用常需要全螢幕體驗(如影音播放、簡報、遊戲)。本文提供跨瀏覽器的純 JavaScript 解決方案,支援進入與退出全螢幕,並相容舊版 IE 的 ActiveX 回退機制。

核心函式:進入全螢幕

function fullScreen() {
  var el = document.documentElement;
  // 依序嘗試標準與各瀏覽器前綴 API
  var rfs = el.requestFullScreen
         || el.webkitRequestFullScreen
         || el.mozRequestFullScreen
         || el.msRequestFullScreen;

  if (typeof rfs !== "undefined" && rfs) {
    rfs.call(el);
    return;
  }

  // IE 舊版回退:模擬按下 F11
  if (typeof window.ActiveXObject !== "undefined") {
    var wscript = new ActiveXObject("WScript.Shell");
    if (wscript) {
      wscript.SendKeys("{F11}");
    }
  }
}

核心函式:退出全螢幕

function exitFullScreen() {
  var el = document;
  var cfs = el.cancelFullScreen
         || el.webkitCancelFullScreen
         || el.mozCancelFullScreen
         || el.exitFullScreen;

  if (typeof cfs !== "undefined" && cfs) {
    cfs.call(el);
    return;
  }

  // IE 舊版回退
  if (typeof window.ActiveXObject !== "undefined") {
    var wscript = new ActiveXObject("WScript.Shell");
    if (wscript !== null) {
      wscript.SendKeys("{F11}");
    }
  }
}

使用範例

<button onclick="fullScreen()">進入全螢幕</button>
<button onclick="exitFullScreen()">退出全螢幕</button>

注意事項

  • 全螢幕請求必須在**使用者互動事件**(如 click)中觸發,否則瀏覽器會攔截。
  • ActiveX 僅在 IE 舊版且信任站點設定允許時生效,現代專案建議僅保留標準 API。
  • 可搭配 document.fullscreenchange 事件監聽狀態變化。

現代化寫法(ES6+)

const toggleFullScreen = () => {
  if (!document.fullscreenElement) {
    document.documentElement.requestFullscreen().catch(err => console.warn(err));
  } else {
    document.exitFullscreen();
  }
};

這組函式簡潔實用,可直接整合至任何專案中,滿足全螢幕切換需求。

copyright © 萬盛學電腦網 all rights reserved