先澄清一件事:標題寫 video 只是因為這個需求最常出現在播放器上。HTML5 的全螢幕 API 其實能套用在任何 HTML 元素上——把一個 div、一個 canvas 甚至整個 documentElement 送進全螢幕都可以。
以下是一個可直接運行的完整範例:
<!doctype html>
<html>
<head>
<meta charset="utf-8" />
<title>全屏問題</title>
<style type="text/css">
* { padding: 0; margin: 0; }
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 { }
:-moz-full-screen { }
:-ms-fullscreen { }
:-o-fullscreen { }
:full-screen { }
:fullscreen { }
:-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>

進入全螢幕必須在使用者互動的呼叫堆疊中執行。放在 setTimeout、AJAX 回呼裡呼叫,Firefox 會直接失敗——這段程式碼裡的註解特別標了出來。
各家的方法名不統一。 WebKit 用的是 webkitRequestFullScreen(大寫 S),Mozilla 是 mozRequestFullScreen,這也是為什麼範例裡寫了 invokeFieldOrMethod 這個反射式的小工具,用來統一探測「目前是否處於全螢幕狀態」。
降級方案不是不能用。 當瀏覽器完全不支援 Fullscreen API 時,把 html、body 與容器统统設成 100% 寬高並隱藏溢出,視覺上也能達到近似效果,代價是仍留有瀏覽器工具列。
multiple source 與 object/embed 的雙保險。 範例同時提供了 ogg、mp4、webm 三種格式,並在最內層用 object/embed 承接舊瀏覽器。這在 HTML5 影片剛普及的年代的確是必要的,今日則可視目標客群簡化。