HTML5 的全屏(Fullscreen)能力,能把使用者的視線強制聚焦到頁面上的某個元素,瀏覽器介面、分頁列,甚至背後的其他應用都會暫時退場。對影片播放、大圖瀏覽、遊戲與簡報這類需要沉浸感的場景來說,這個 API 幾乎是標配。
麻煩的是,W3C 的全屏規範當年還沒走到最終版本,各家瀏覽器於是各自掛上前綴搶先實作:微軟用 ms、Firefox 用 moz、WebKit 系用 webkit。同一個需求,往往得寫上三四份大同小異的程式碼。
比較務實的解法是寫一個統一的外層函式,把「偵測支援 → 進入全屏 → 查詢狀態 → 退出全屏」這幾件事全部收攏,並且讓探測順序把標準名稱擺第一、前綴版本跟在後頭。這樣在已支援標準的瀏覽器上,就能直接走最精簡的那條路徑,不必多繞好幾圈判斷。
先看清楚彼此差異在哪,後面的封裝才會好讀:
/* WebKit(Safari 5.1 / Chrome 15 起) */
element.webkitRequestFullScreen();
document.webkitCancelFullScreen();
document.webkitIsFullScreen;
// 實測 Chrome 39 亦可使用 document.webkitExitFullscreen()
/* Firefox 10+ */
element.mozRequestFullScreen();
document.mozCancelFullScreen();
document.mozFullScreen;
/* IE11 */
element.msRequestFullscreen();
document.msExitFullscreen();
/* W3C 標準寫法 */
element.requestFullscreen();
document.exitFullscreen();
document.fullscreen;
可以注意到一個細節:進入用的動詞各家不太一致(RequestFullScreen 與 RequestFullscreen 大小寫不同),退出用的名稱更是分成 Cancel 與 Exit 兩派。這正是封裝時最容易踩到的坑。
!function (w, d) {
var fs = {
supportsFullScreen: false,
isFullScreen: false,
requestFullScreen: '',
exitFullScreen: '',
fullscreenchange: '',
prefix: ''
},
aP = ['webkit', 'moz', 'ms'], // Opera 15 之後改用 webkit 內核
len = aP.length,
i = 0;
// 先問標準,再逐一問前綴版本
if (d.exitFullscreen) {
fs.supportsFullScreen = true;
} else {
for (; i < len; i++) {
if (d[aP[i] + 'ExitFullscreen'] || d[aP[i] + 'CancelFullScreen']) {
fs.supportsFullScreen = true;
fs.prefix = aP[i];
break;
}
}
}
if (fs.supportsFullScreen) {
var p = fs.prefix;
// 綁定 fullscreenchange,IE 的拼法剛好不一樣
fs.fullscreenchange = function (fn) {
d.addEventListener(p == 'ms' ? 'MSFullscreenChange' : p + 'fullscreenchange', function () {
fn && fn();
}, false);
};
fs.fullscreenchange(function () {
fs.isFullScreen = (function (p) {
switch (p) {
case '': return d.fullscreen;
case 'webkit': return d.webkitIsFullScreen;
case 'moz': return d.mozFullScreen;
case 'ms': return d.msFullscreenElement ? true : false;
}
})(p);
});
fs.requestFullScreen = function (elem) {
var elem = elem || d.documentElement;
try {
p ? elem[p + 'RequestFullScreen']() : elem.requestFullScreen();
// Chrome、Firefox 與標準寫法
} catch (e) {
elem[p + 'RequestFullscreen'](); // IE 的 msRequestFullscreen
}
};
fs.exitFullScreen = function () {
try {
p ? d[p + 'ExitFullscreen']() : d.exitFullscreen();
// IE、新版 Chrome 與標準寫法
} catch (e) {
d[p + 'CancelFullScreen'](); // 舊版 Chrome、Firefox
}
};
}
w.fs = fs;
}(window, document);
這裡有兩個設計意圖值得說明。第一,supportsFullScreen 是一次性的能力偵測,呼叫端不必每按一次就重新判斷瀏覽器;第二,進入與退出都用 try/catch 再包一層,因為同樣帶 webkit 前綴的瀏覽器,方法名也可能存在差異,與其窮舉版本號,不如讓它失敗後走另一條路。
<body>
<div id="launch">進入全屏</div>
</body>
<script>
var oBtn = document.getElementById('launch');
oBtn.onclick = function () {
if (fs.supportsFullScreen) {
fs.isFullScreen
? (fs.exitFullScreen(), this.innerHTML = '進入全屏')
: (fs.requestFullScreen(), this.innerHTML = '退出全屏');
} else {
alert('Sorry: Your browser does not support fullScreen preview.');
}
};
// 使用者按 ESC 退出時,按鈕文字也要跟著同步
fs.fullscreenchange(function () {
oBtn.innerHTML = fs.isFullScreen ? '退出全屏' : '進入全屏';
});
</script>
最後那段 fullscreenchange 的監聽不能省。使用者隨時可以按 ESC 或 F11 離開全屏,如果只靠點擊事件切換文字,狀態很快就會對不上。想要指定某個特定元素進入全屏(例如只放大影片容器),把該元素傳進 fs.requestFullScreen(elem) 即可,不傳則預設放大整個 documentElement。
完整的支援度可以查 Can I Use:https://caniuse.com/#feat=fullscreen。基本上 IE11、Edge、Chrome、Firefox、Safari 的桌面版與行動版都已支援,差別只在於是否走前綴,以及舊版 WebKit 是否提供 webkitExitFullscreen 這個拼法。
若想延伸閱讀,這幾份資料對各家差異的說明相當細緻:
https://www.zhangxinxu.com/wordpress/2012/10/Html5-full-screen-api-Firefox-Chrome-difference/https://www.wufangbo.com/Html5-quanping/https://heeroluo.net/article/detail/97https://msdn.microsoft.com/zh-cn/library/ie/dn265028(v=vs.85).aspx最後提醒一句:現代專案如果不必支援 IE11,直接用標準的 requestFullscreen() 與 exitFullscreen() 就足夠了,這層封裝主要是留給仍需兼顧舊環境的維護場景。