啟動全螢幕需呼叫元素的 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('離開全螢幕');
}
}
瀏覽器提供偽類選取器,可針對全螢幕狀態調整樣式:
/* 標準語法 */
: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>
<iframe> 需有 allowfullscreen 屬性,且同源或設定 allow="fullscreen"。box-sizing 影響,建議設 width:100%; height:100%;。<video> 原生全螢幕,任意元素全螢幕受限。