專案上有個需求:後台頁面希望能點一個按鈕就進入全螢幕,效果等同於手動按下 F11。過去只能靠一些取巧手法,但 HTML5 已經把這件事標準化了。W3C 制定的 Fullscreen API 讓我們可以直接把整個頁面,甚至單一張圖片或一段影片,推送成全螢幕狀態。
需要注意的是瀏覽器支援度:Chrome 15+、Safari 5.1+、Firefox 10+、IE11 以上才有完整的支援,因此在正式環境中務必做好 feature detection 與降級處理。
寫法上要針對各家瀏覽器加上前綴,順序判斷即可:
var docElm = document.documentElement;
// 標準寫法
if (docElm.requestFullscreen) {
docElm.requestFullscreen();
}
// Firefox
else if (docElm.mozRequestFullScreen) {
docElm.mozRequestFullScreen();
}
// Chrome、Safari 等
else if (docElm.webkitRequestFullScreen) {
docElm.webkitRequestFullScreen();
}
// IE11
else if (docElm.msRequestFullscreen) {
docElm.msRequestFullscreen();
}
離開全螢幕的 API 挂在 document 上,名稱也和進入時不同,這是最容易寫錯的地方:
if (document.exitFullscreen) {
document.exitFullscreen();
} else if (document.mozCancelFullScreen) {
document.mozCancelFullScreen();
} else if (document.webkitCancelFullScreen) {
document.webkitCancelFullScreen();
} else if (document.msExitFullscreen) {
document.msExitFullscreen();
}
實務上很常需要知道「目前是否處於全螢幕」,例如要切換按鈕的圖示或文字。這時候註冊 fullscreenchange 事件即可,一樣要補上前綴版本:
document.addEventListener('fullscreenchange', function () {
fullscreenState.innerHTML = (document.fullscreen) ? '' : 'not ';
}, false);
document.addEventListener('mozfullscreenchange', function () {
fullscreenState.innerHTML = (document.mozFullScreen) ? '' : 'not ';
}, false);
document.addEventListener('webkitfullscreenchange', function () {
fullscreenState.innerHTML = (document.webkitIsFullScreen) ? '' : 'not ';
}, false);
document.addEventListener('msfullscreenchange', function () {
fullscreenState.innerHTML = (document.msFullscreenElement) ? '' : 'not ';
}, false);
進入全螢幕後,頁面會脫離原本的外框,這時候可以用偽類別針對全螢幕狀態單獨設計樣式,例如換一個更單純的背景色:
html:-moz-full-screen {
background: red;
}
html:-webkit-full-screen {
background: red;
}
html:fullscreen {
background: red;
}
小提醒:全螢幕必須由使用者互動觸發,也就是說一定要綁在 click、keydown 這類手勢事件裡,若在頁面載入時自動呼叫,瀏覽器會直接忽略。另外 iOS Safari 對元素級別的全螢幕支援仍不完整,行動端建議改用 video 的原生播放全螢幕,或是以固定定位的偽全螢幕版面因應。