DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
HTML5 Fullscreen API 完整指南:進入/退出全螢幕、屬性、事件與 CSS
編輯:HTML5詳解     

Web 應用越做越像真正的應用程式,JavaScript 的能力也跟著水漲船高。Fullscreen API 就是一個小而美的例子:它讓你可以透過程式向使用者請求全螢幕顯示,互動結束後再隨時退出。

最典型的應用場景是媒體播放、遊戲、簡報與圖表儀表板——凡是「使用者需要專注」的地方,把瀏覽器介面隱藏起來都有明顯價值。

啟動全螢幕模式

要特別注意:這個 API 的各家 prefix 差異比一般 API 嚴重得多,正式環境幾乎一定要寫相容處理。

// 找到支援的方法,用需要做全螢幕的元素呼叫
function launchFullScreen(element) {
    if (element.requestFullscreen) {
        element.requestFullscreen();
    } else if (element.mozRequestFullScreen) {
        element.mozRequestFullScreen();
    } else if (element.webkitRequestFullscreen) {
        element.webkitRequestFullscreen();
    } else if (element.msRequestFullscreen) {
        element.msRequestFullscreen();
    }
}

// 让整个页面进入全屏
launchFullScreen(document.documentElement);

// 或只让某个元素进入全屏,例如一个影片播放器
launchFullScreen(document.getElementById("videoElement"));

把目標 DOM 元素當參數傳入即可。成功之後,工具列與其他瀏覽器元件會隱藏起來,document 框架的寬高會橫跨整個螢幕。

值得注意的是,全螢幕請求通常需要使用者手勢觸發(例如綁在 click 事件上)。若在頁面載入時自動呼叫,多數瀏覽器會直接忽略;若使用者拒絕,則可能出現各種「不完全的全螢幕」狀態。

退出全螢幕模式

function exitFullscreen() {
    if (document.exitFullscreen) {
        document.exitFullscreen();
    } else if (document.mozExitFullScreen) {
        document.mozExitFullScreen();
    } else if (document.webkitExitFullscreen) {
        document.webkitExitFullscreen();
    }
}

// 呼叫退出
exitFullscreen();

這裡有個容易寫錯的地方:exitFullscreen 只能透過 document 物件呼叫,而不是用普通的 DOM 元素。進入時是「某個元素請求」,退出時則是「整個文件退出」,兩者的呼叫主體不同。

屬性與事件

Fullscreen 相關的屬性與事件目前同樣帶有 prefix,好消息是主流瀏覽器已大致完成標準化。兩個核心屬性:

  • document.fullscreenElement:當前處於全螢幕狀態的元素。若為 null,代表目前沒有全螢幕。
  • document.fullscreenEnabled:標記 Fullscreen 功能目前是否可用。

相容寫法:

var fullscreenElement = document.fullscreenElement
                     || document.mozFullscreenElement
                     || document.webkitFullscreenElement;

var fullscreenEnabled = document.fullscreenEnabled
                     || document.mozFullscreenEnabled
                     || document.webkitFullscreenEnabled;

進入或退出全螢幕時,會觸發 fullscreenchange 事件。實作上建議在初始化階段先探測該監聽哪一個事件名稱:

var fsChange = document.onfullscreenchange ? 'fullscreenchange'
             : document.onmozfullscreenchange ? 'mozfullscreenchange'
             : document.onwebkitfullscreenchange ? 'webkitfullscreenchange'
             : null;

if (fsChange) {
    document.addEventListener(fsChange, function () {
        var isFull = !!(document.fullscreenElement
                     || document.mozFullscreenElement
                     || document.webkitFullscreenElement);
        console.log('全螢幕狀態:', isFull);
    });
}

瀏覽器也提供了 fullscreenerror 事件,用來捕捉請求失敗的情況(例如缺少使用者手勢、或權限被拒),建議一併監聽,避免使用者按了卻毫無反應。

Fullscreen CSS

瀏覽器提供了一些專用的 CSS 規則供你調整全螢幕下的樣式:

/* html 元素本身 */
:-webkit-full-screen {
    /* properties */
}
:-moz-fullscreen {
    /* properties */
}
:fullscreen {
    /* properties */
}

/* 全螢幕下的深層元素 */
:-webkit-full-screen video {
    width: 100%;
    height: 100%;
}

/* 樣式化背景墊層 */
::backdrop {
    /* properties */
}

其中 WebKit 需要額外處理的情況比較多,處理多媒體時經常需要用到上面那段 video 的規則,否則影片在全螢幕下可能不會填滿整個畫面。::backdrop 則是用來樣式化元素背後那層覆蓋的底色。

實務上的幾個提醒

第一,別忘了 iOS Safari。iPhone 上的 Safari 對 Fullscreen API 支援我向來保守,<video> 有自己專用的 webkitEnterFullscreen(),而一般元素的全螢幕在 iPhone 上長期不可用。如果你的目標使用者包含 iOS,一定要準備好替代方案。

第二,記得處理 resize。進入與退出全螢幕會改變可用空間,任何依賴尺寸計算的版面(canvas、圖表、地圖)都應該在 fullscreenchange 裡重新量測並重繪。

第三,一定要提供明顯的退出入口。除了 Esc 鍵,畫面上最好有一個可見的關閉按鈕,行動裝置尤其如此。

整體來說,Fullscreen API 簡單、實用、沒有學習門檻。MDN 那個名為 BananaBread 的全客戶端第一人稱射擊遊戲,就是一個把全螢幕用在其刀刃上的絕佳案例——值得記住這個 API,總有一天會派上用場。

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