萬盛學電腦網

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

JavaScript 控制瀏覽器全螢幕模式:API、屬性、事件與 CSS 完整指南

全螢幕 API 核心方法

啟動全螢幕需呼叫元素的 requestFullscreen(),退出呼叫 document.exitFullscreen()。因歷史原因需加廠商前綴。

通用啟動函式

function launchFullscreen(element) {
  if (element.requestFullscreen) {
    element.requestFullscreen();
  } else if (element.mozRequestFullScreen) { // Firefox
    element.mozRequestFullScreen();
  } else if (element.webkitRequestFullscreen) { // Chrome, Safari, Opera
    element.webkitRequestFullscreen();
  } else if (element.msRequestFullscreen) { // IE/Edge
    element.msRequestFullscreen();
  }
}

// 使用:整頁或特定元素
launchFullscreen(document.documentElement); // 整頁
launchFullscreen(document.getElementById("videoElement")); // 單一元素(如影片)

通用退出函式

注意:只能在 document 上呼叫,不能在元素上。

function exitFullscreen() {
  if (document.exitFullscreen) {
    document.exitFullscreen();
  } else if (document.mozCancelFullScreen) {
    document.mozCancelFullScreen();
  } else if (document.webkitExitFullscreen) {
    document.webkitExitFullscreen();
  } else if (document.msExitFullscreen) {
    document.msExitFullscreen();
  }
}

exitFullscreen();

全螢幕屬性與事件

屬性/事件說明標準化名稱
fullscreenElement目前全螢幕的元素document.fullscreenElement
fullscreenEnabled文件是否允許全螢幕document.fullscreenEnabled
fullscreenchange進入/離開全螢幕時觸發document.onfullscreenchange
fullscreenerror全螢幕請求失敗時觸發document.onfullscreenerror

跨瀏覽器屬性存取

var fullscreenElement = document.fullscreenElement
  || document.mozFullScreenElement
  || document.webkitFullscreenElement
  || document.msFullscreenElement;

var fullscreenEnabled = document.fullscreenEnabled
  || document.mozFullScreenEnabled
  || document.webkitFullscreenEnabled
  || document.msFullscreenEnabled;

監聽變化事件

document.addEventListener('fullscreenchange', handleChange);
document.addEventListener('webkitfullscreenchange', handleChange); // Safari
document.addEventListener('mozfullscreenchange', handleChange);   // Firefox
document.addEventListener('MSFullscreenChange', handleChange);    // IE/Edge

function handleChange() {
  var elem = fullscreenElement;
  if (elem) {
    console.log('進入全螢幕:', elem);
  } else {
    console.log('離開全螢幕');
  }
}

全螢幕 CSS 樣式控制

瀏覽器提供偽類選取器,可針對全螢幕狀態調整樣式:

/* 標準語法 */
:fullscreen { /* 標準 */ }
:full-screen { /* 早期草案 */ }

/* 廠商前綴 */
:-webkit-full-screen { /* Chrome, Safari, Opera */ }
:-moz-full-screen { /* Firefox */ }
:-ms-fullscreen { /* IE/Edge */ }

/* 針對全螢幕內的特定元素 */
:-webkit-full-screen video {
  width: 100%;
  height: 100%;
}

/* 背景遮罩 */
::backdrop { /* 標準 */ }
::-ms-backdrop { /* IE/Edge */ }

實用應用範例:影片播放器全螢幕切換

<video id="player" src="movie.mp4" controls></video>
<button id="fsBtn">全螢幕</button>

<script>
var video = document.getElementById('player');
var btn = document.getElementById('fsBtn');

btn.addEventListener('click', function() {
  if (document.fullscreenElement === video) {
    exitFullscreen();
    btn.textContent = '全螢幕';
  } else {
    launchFullscreen(video);
    btn.textContent = '離開全螢幕';
  }
});

// 同步按鈕狀態
document.addEventListener('fullscreenchange', function() {
  btn.textContent = document.fullscreenElement === video ? '離開全螢幕' : '全螢幕';
});
</script>

常見坑點與注意事項

  • 使用者手勢必要:全螢幕請求必須在使用者互動事件(click、keydown)中發起,否則會被瀏覽器拒絕。
  • iframe 跨域限制:<iframe> 需有 allowfullscreen 屬性,且同源或設定 allow="fullscreen"。
  • CSS 盒模型差異:全螢幕時元素尺寸可能受 box-sizing 影響,建議設 width:100%; height:100%;。
  • iOS Safari 限制:僅支援 <video> 原生全螢幕,任意元素全螢幕受限。
copyright © 萬盛學電腦網 all rights reserved