本文示範如何借助瀏覽器的全屏 API 實現 JavaScript 全屏功能,並透過 jQuery 封裝成外掛,同時相容各家瀏覽器的私有前綴。
由於各瀏覽器對全屏 API 的支援不同,程式先偵測原生支援與各家前綴(webkit、moz、o、ms、khtml),再動態補上對應方法:
(function () {
var fullScreenApi = {
supportsFullScreen: false,
isFullScreen: function () { return false; },
requestFullScreen: function () {},
cancelFullScreen: function () {},
fullScreenEventName: '',
prefix: ''
},
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 === '') ? document.cancelFullScreen() : document[this.prefix + 'CancelFullScreen']();
}
}
// jQuery 外掛
if (typeof jQuery != 'undefined') {
jQuery.fn.requestFullScreen = function () {
return this.each(function () {
if (fullScreenApi.supportsFullScreen) {
fullScreenApi.requestFullScreen(this);
}
});
};
}
// 導出 api
window.fullScreenApi = fullScreenApi;
})();
$(function () {
$("#fullScreenBtn").click(function () {
$("#fullScreen").requestFullScreen();
});
if (window.top != self) {
$("#tip").text("iframe 裡面不能演示該功能!請點擊右下角的全屏查看!").show();
}
});
if (!fullScreenApi.supportsFullScreen) {
alert("您的瀏覽器不支持全屏 API,請換高版本的 chrome 或 firefox!");
}
頁面上放一個觸發按鈕與要全屏的容器:
<button id="fullScreenBtn">點擊我進入全屏模式</button> <div id="fullScreen" class="fullScreen"> <h1>我是全屏區域的內容!</h1> <div id="tip" style="display:none;"></div> </div>
CSS 部分需針對各家前綴撰寫全屏樣式,讓全屏時寬高填滿整個螢幕:
.fullScreen:full-screen,
.fullScreen:fullscreen,
.fullScreen:-webkit-full-screen,
.fullScreen:-moz-full-screen {
width: 100%;
height: 100%;
}
如此一來,點擊按鈕即可讓指定區域進入全屏模式,並在 iframe 內嵌時給出友善提示。