想要讓某個區塊以全螢幕方式呈現嗎?HTML5 的 Fullscreen API 讓這件事變得簡單,但各家瀏覽器的私有前綴五花八門。以下示範如何封裝一個相容多瀏覽器的全螢幕工具,並做成 jQuery 外掛,一行就能呼叫。
關鍵在於先偵測原生支援,再逐一嘗試 webkit、moz、o、ms 等前綴,最後把對應的進入、退出與狀態查詢方法掛到統一介面上。
(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']();
}
}
if (typeof jQuery != 'undefined') {
jQuery.fn.requestFullScreen = function () {
return this.each(function () {
if (fullScreenApi.supportsFullScreen) { fullScreenApi.requestFullScreen(this); }
});
};
}
window.fullScreenApi = fullScreenApi;
})();
$(function(){
$("#fullScreenBtn").click(function(){ $("#fullScreen").requestFullScreen(); });
if(window.top != self){
$("#tip").text("iframe裡面不能演示該功能!請點擊右下角的全屏查看!").show();
}
});
if (!fullScreenApi.supportsFullScreen) {
alert("您的瀏覽器不支援全螢幕 API,請更換新版的 Chrome 或 Firefox!");
}
<!DOCTYPE html> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>javascript啟用全屏</title> <script src="jquery-1.8.3.min.js"></script> </head> <body> <button id="fullScreenBtn">點擊我進入全屏模式</button> <div id="fullScreen" class="fullScreen"> <h1>我是全屏區域的內容!</h1> <div id="tip" style="display:none;"></div> </div> </body> </html>
記得同時寫上各家前綴的 :full-screen 偽類別,讓元素在全螢幕時填滿寬高。
.fullScreen{ padding-top:10%; text-align:center; background: #FFFFFF; }
.fullScreen:full-screen,
.fullScreen:fullscreen,
.fullScreen:-webkit-full-screen,
.fullScreen:-moz-full-screen { width:100%; height:100%; }
要注意的是,全螢幕通常需要由使用者點擊觸發,且 iframe 內建置往往受限,實際部署時建議直接在新分頁測試。