首先要澄清的是,全螢幕(fullScreen)並不是 video 專屬的功能。在 HTML5 中,全螢幕 API 可以套用在許多元素上,只是因為 video 的使用情境最為常見,所以本文以 video 為例來示範。
由於各家瀏覽器對全螢幕 API 的實作名稱不一,因此程式中需要針對 webkit、moz、ms、o 等前綴做相容處理。以下提供一份完整的實作範例。
<!doctype Html>
<Html>
<head>
<meta charset="utf-8" />
<title>全螢幕問題</title>
<style type="text/CSS">
* { padding: 0px; margin: 0px; }
body div.videobox {
width: 400px;
height: 320px;
margin: 100px auto;
background-color: #000;
}
body div.videobox video.video {
width: 100%;
height: 100%;
}
:-webkit-full-screen video { width: 100%; height: 100%; }
:-moz-full-screen video { width: 100%; height: 100%; }
</style>
</head>
<body>
<div id="videobox">
<video controls="controls" preload="preload" id="video" poster="poster.jpg">
<source src="./movIE.ogg" type="video/ogg" />
<source src="./movIE.mp4" type="video/mp4" />
<source src="./movIE.webm" type="video/webm" />
<object data="./movIE.mp4" width="100%" height="100%">
<embed width="100%" height="100%" src="./movIE.swf" />
</object>
</video>
<button id="fullScreenBtn">全屏</button>
</div>
<script type="text/Javascript">
// 反射式取得各瀏覽器可用的方法或屬性
var invokeFieldOrMethod = function (element, method) {
var usablePrefixMethod;
["webkit", "moz", "ms", "o", ""].forEach(function (prefix) {
if (usablePrefixMethod) return;
if (prefix === "") {
// 無前綴時,方法名首字母改小寫
method = method.slice(0, 1).toLowerCase() + method.slice(1);
}
var typePrefixMethod = typeof element[prefix + method];
if (typePrefixMethod + "" !== "undefined") {
if (typePrefixMethod === "function") {
usablePrefixMethod = element[prefix + method]();
} else {
usablePrefixMethod = element[prefix + method];
}
}
});
return usablePrefixMethod;
};
// 進入全螢幕
function launchFullscreen(element) {
// 此段不可寫在迴圈中,否則 Firefox 無法全螢幕
if (element.requestFullscreen) {
element.requestFullscreen();
} else if (element.mozRequestFullScreen) {
element.mozRequestFullScreen();
} else if (element.msRequestFullscreen) {
element.msRequestFullscreen();
} else if (element.oRequestFullscreen) {
element.oRequestFullscreen();
} else if (element.webkitRequestFullscreen) {
element.webkitRequestFullScreen();
} else {
// 後備方案:以 CSS 模擬全螢幕
var docHtml = document.documentElement;
var docBody = document.body;
var videobox = document.getElementById('videobox');
var CSSText = 'width:100%;height:100%;overflow:hidden;';
docHtml.style.cssText = CSSText;
docBody.style.cssText = CSSText;
videobox.style.cssText = CSSText + ';' + 'margin:0px;padding:0px;';
document.IsFullScreen = true;
}
}
// 退出全屏
function exitFullscreen() {
if (document.exitFullscreen) {
document.exitFullscreen();
} else if (document.msExitFullscreen) {
document.msExitFullscreen();
} else if (document.mozCancelFullScreen) {
document.mozCancelFullScreen();
} else if (document.oCancelFullScreen) {
document.oCancelFullScreen();
} else if (document.webkitExitFullscreen) {
document.webkitExitFullscreen();
} else {
var docHtml = document.documentElement;
var docBody = document.body;
var videobox = document.getElementById('videobox');
docHtml.style.cssText = "";
docBody.style.cssText = "";
videobox.style.cssText = "";
document.IsFullScreen = false;
}
}
document.getElementById('fullScreenBtn').addEventListener('click', function () {
launchFullscreen(document.getElementById('video'));
window.setTimeout(function exit() {
// 檢查是否處於全螢幕狀態
if (invokeFieldOrMethod(document, 'FullScreen')
|| invokeFieldOrMethod(document, 'IsFullScreen')
|| document.IsFullScreen) {
exitFullscreen();
}
}, 5 * 1000);
}, false);
</script>
</body>
</Html>
這份範例的重點在於:launchFullscreen 負責進入全螢幕,exitFullscreen 負責退出,兩者都對各家瀏覽器的前綴寫法做了逐一判斷;而 invokeFieldOrMethod 則用反射的方式自動找出當前環境可用的方法。若所有原生 API 都不可用時,還提供了以 CSS 撐滿視窗的後備方案,確保功能在各種環境下都能正常運作。