DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
一次搞定跨瀏覽器 Fullscreen API:封裝、呼叫與相容性整理
編輯:HTML5詳解     

為什麼值得自己包一層?

HTML5 的全屏(Fullscreen)能力,能把使用者的視線強制聚焦到頁面上的某個元素,瀏覽器介面、分頁列,甚至背後的其他應用都會暫時退場。對影片播放、大圖瀏覽、遊戲與簡報這類需要沉浸感的場景來說,這個 API 幾乎是標配。

麻煩的是,W3C 的全屏規範當年還沒走到最終版本,各家瀏覽器於是各自掛上前綴搶先實作:微軟用 ms、Firefox 用 moz、WebKit 系用 webkit。同一個需求,往往得寫上三四份大同小異的程式碼。

比較務實的解法是寫一個統一的外層函式,把「偵測支援 → 進入全屏 → 查詢狀態 → 退出全屏」這幾件事全部收攏,並且讓探測順序把標準名稱擺第一、前綴版本跟在後頭。這樣在已支援標準的瀏覽器上,就能直接走最精簡的那條路徑,不必多繞好幾圈判斷。

各瀏覽器的 API 名稱對照

先看清楚彼此差異在哪,後面的封裝才會好讀:

/* 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/97
  • 微軟開發者中心:https://msdn.microsoft.com/zh-cn/library/ie/dn265028(v=vs.85).aspx

最後提醒一句:現代專案如果不必支援 IE11,直接用標準的 requestFullscreen() 與 exitFullscreen() 就足夠了,這層封裝主要是留給仍需兼顧舊環境的維護場景。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved