HTML5 的 Fullscreen API 讓網頁能請求進入全螢幕模式,很適合用來做圖片檢視、簡報或遊戲。以下是一個可直接執行的完整範例:點擊圖片,該容器會填滿整個螢幕,再點一次即可退出。
這個 API 在標準化過程中各家瀏覽器使用了不同的前綴,因此實務上必須做能力偵測與方法映射。範例把這些差異封裝成一個 fullScreenApi 物件,對外只暴露四個方法:
supportsFullScreen:瀏覽器是否支援isFullScreen():目前是否處於全螢幕狀態requestFullScreen(el):請求讓 el 進入全螢幕cancelFullScreen(el):退出全螢幕關鍵是針對各家的全螢幕偽類別(:-webkit-full-screen、:-moz-full-screen)設定填滿視窗並讓圖片置中:
* { margin: 0; padding: 0; }
img { display: block; margin: 0 auto; }
.imgContainer:-webkit-full-screen,
.imgContainer:-moz-full-screen {
width: 100%; height: 100%;
background: #000;
text-align: center;
position: fixed;
left: 0; top: 0; right: 0; bottom: 0;
display: table-cell;
vertical-align: middle;
}
.imgContainer:-webkit-full-screen img,
.imgContainer:-moz-full-screen img {
max-width: 100%;
display: inline-block;
vertical-align: middle;
cursor: zoom-out;
}
(function () {
var fullScreenApi = {
supportsFullScreen: false,
isFullScreen: function () { return false; },
requestFullScreen: function () {},
cancelFullScreen: function () {},
prefix: ''
};
var browserPrefixes = 'webkit moz o ms khtml'.split(' ');
if (typeof document.cancelFullScreen != 'undefined') {
fullScreenApi.supportsFullScreen = true;
} else {
for (var i = 0, il = browserPrefixes.length; i < il; i++) {
fullScreenApi.prefix = browserPrefixes[i];
if (typeof document[fullScreenApi.prefix + 'CancelFullScreen'] != 'undefined') {
fullScreenApi.supportsFullScreen = true;
break;
}
}
}
if (fullScreenApi.supportsFullScreen) {
fullScreenApi.fullScreenEventName = fullScreenApi.prefix + 'fullscreenchange';
fullScreenApi.isFullScreen = function () {
switch (this.prefix) {
case '': return document.fullScreen;
case 'webkit': return document.webkitIsFullScreen;
default: return document[this.prefix + 'FullScreen'];
}
};
fullScreenApi.requestFullScreen = function (el) {
return (this.prefix === '')
? el.requestFullScreen()
: el[this.prefix + 'RequestFullScreen']();
};
fullScreenApi.cancelFullScreen = function (el) {
return (this.prefix === '')
? el.cancelFullScreen()
: el[this.prefix + 'CancelFullScreen']();
};
}
window.fullScreenApi = fullScreenApi;
})();
注意 WebKit 是唯一例外:它的狀態查詢方法叫 webkitIsFullScreen,與其他家的命名規則不同,所以 isFullScreen 裡要特別分出這一支。
<div class="imgContainer">
<a href="javascript:void(0)"><img src="photo1.jpg"></a>
</div>
<div class="imgContainer">
<a href="javascript:void(0)"><img src="photo2.jpg"></a>
</div>
<script type="text/javascript">
window.onload = function () {
if (!window.fullScreenApi.supportsFullScreen) { return; }
var containers = document.getElementsByTagName('div');
for (var i = 0; i < containers.length; i++) {
containers[i].addEventListener('click', function () {
if (!fullScreenApi.isFullScreen()) {
this.style.lineHeight = window.screen.height + 'px';
window.fullScreenApi.requestFullScreen(this);
} else {
window.fullScreenApi.cancelFullScreen(document);
}
}, true);
}
};
</script>
點擊時先確認目前狀態:非全螢幕就請求進入,並把行高設為螢幕高度以輔助置中;已在全螢幕則取消。以 Chrome 或 Firefox 開啟即可看到效果。
三點值得注意:一是全螢幕請求必須由使用者互動觸發,若在頁面載入時自動呼叫會被瀏覽器阻擋;二是進入全螢幕後,瀏覽器位址列隱藏,使用者習慣的返回操作失效,介面需提供明確的退出入口;三是範例中 containers[i] 的迴圈變數若直接放進事件回呼,會有閉包捕獲問題,實務上應改用 let 或提前將元素賦值給區域變數。此外,這些前綴寫法多已退場,現代專案只需使用標準的 requestFullscreen() 與 fullscreenchange 即可。