打造全螢幕體驗

我們能輕鬆製作沉浸式全螢幕網站和應用程式,但就像網路上的任何內容一樣,有幾種方法可以做到。現在有更多瀏覽器支援「已安裝的網頁應用程式」體驗,會以全螢幕模式啟動,因此這點特別重要。

讓應用程式或網站全螢幕顯示

使用者或開發人員可以透過多種方式,讓網頁應用程式全螢幕顯示。

  • 要求瀏覽器根據使用者手勢進入全螢幕模式。
  • 將應用程式安裝到主畫面。
  • 假裝:自動隱藏網址列。

要求瀏覽器根據使用者手勢進入全螢幕模式

並非所有平台都相同。iOS Safari 沒有全螢幕 API,但 Android 版 Chrome、Firefox 和 IE 11 以上版本有。您建構的大多數應用程式都會結合使用 JS API 和全螢幕規格提供的 CSS 選取器。建構全螢幕體驗時,您需要留意的 JS API 主要包括:

  • element.requestFullscreen() (目前在 Chrome、Firefox 和 IE 中有前置字元) 會以全螢幕模式顯示元素。
  • document.exitFullscreen() (目前在 Chrome、Firefox 和 IE 中有前置字元。 Firefox 改用 cancelFullScreen()) 取消全螢幕模式。
  • 如果任何元素處於全螢幕模式,document.fullscreenElement (目前在 Chrome、Firefox 和 IE 中有前置字元) 會傳回 true。

應用程式全螢幕顯示時,您就無法再使用瀏覽器的 UI 控制項。這會改變使用者與體驗互動的方式。這類應用程式沒有標準導覽控制項,例如「前進」和「返回」,也沒有「重新整理」按鈕這個緊急出口。請務必考量這種情況。您可以使用一些 CSS 選取器,在瀏覽器進入全螢幕模式時,變更網站的樣式和呈現方式。

<button id="goFS">Go fullscreen</button>
<script>
  var goFS = document.getElementById('goFS');
  goFS.addEventListener(
    'click',
    function () {
      document.body.requestFullscreen();
    },
    false,
  );
</script>

上述範例有點刻意,我隱藏了所有與使用供應商前置字元相關的複雜性。

實際的程式碼複雜得多。Mozilla 建立了一個非常實用的指令碼,可用來切換全螢幕模式。如您所見,與指定 API 相比,供應商前置字元的情況複雜且繁瑣。即使使用下方稍微簡化的程式碼,仍相當複雜。

function toggleFullScreen() {
  var doc = window.document;
  var docEl = doc.documentElement;

  var requestFullScreen =
    docEl.requestFullscreen ||
    docEl.mozRequestFullScreen ||
    docEl.webkitRequestFullScreen ||
    docEl.msRequestFullscreen;
  var cancelFullScreen =
    doc.exitFullscreen ||
    doc.mozCancelFullScreen ||
    doc.webkitExitFullscreen ||
    doc.msExitFullscreen;

  if (
    !doc.fullscreenElement &&
    !doc.mozFullScreenElement &&
    !doc.webkitFullscreenElement &&
    !doc.msFullscreenElement
  ) {
    requestFullScreen.call(docEl);
  } else {
    cancelFullScreen.call(doc);
  }
}

網頁程式開發人員討厭複雜。您可以使用的優質高階抽象 API 是 Sindre Sorhus 的 Screenfull.js 模組,可將兩個略有不同的 JS API 和供應商前置字元整合為一個一致的 API。

Fullscreen API 提示

將文件設為全螢幕
在 body 元素上全螢幕顯示
圖 1:body 元素的全螢幕模式。

您可能會自然而然地認為,您將 body 元素設為全螢幕,但如果您使用的是以 WebKit 或 Blink 為基礎的轉譯引擎,就會發現它會產生奇怪的效果,將 body 寬度縮小到可容納所有內容的最小可能大小。(Mozilla Gecko 沒問題)。

全螢幕顯示文件元素
圖 2:文件元素的全螢幕模式。

如要修正這個問題,請使用 document 元素,而非 body 元素:

document.documentElement.requestFullscreen();
將影片元素設為全螢幕

將影片元素設為全螢幕,與將其他元素設為全螢幕完全相同。您在影片元素上呼叫 requestFullscreen 方法。

<video id="videoElement"></video>
<button id="goFS">Go Fullscreen</button>
<script>
  var goFS = document.getElementById('goFS');
  goFS.addEventListener(
    'click',
    function () {
      var videoElement = document.getElementById('videoElement');
      videoElement.requestFullscreen();
    },
    false,
  );
</script>

如果 <video> 元素未定義控制項屬性,使用者就無法在全螢幕模式下控制影片。建議做法是使用基本容器,包裝影片和要向使用者顯示的控制項。

<div id="container">
  <video></video>
  <div>
    <button>Play</button>
    <button>Stop</button>
    <button id="goFS">Go fullscreen</button>
  </div>
</div>
<script>
  var goFS = document.getElementById('goFS');
  goFS.addEventListener(
    'click',
    function () {
      var container = document.getElementById('container');
      container.requestFullscreen();
    },
    false,
  );
</script>

這可讓您更靈活地結合容器物件和 CSS 虛擬選取器 (例如隱藏「goFS」按鈕)。

<style>
  #goFS:-webkit-full-screen #goFS {
    display: none;
  }
  #goFS:-moz-full-screen #goFS {
    display: none;
  }
  #goFS:-ms-fullscreen #goFS {
    display: none;
  }
  #goFS:fullscreen #goFS {
    display: none;
  }
</style>

您可以使用這些模式偵測全螢幕模式是否正在執行,並適當調整使用者介面,例如:

  • 提供返回起始頁面的連結
  • 提供關閉對話方塊或返回上一步的機制

從主畫面以全螢幕模式啟動頁面

使用者前往網頁時,無法啟動全螢幕網頁。 瀏覽器供應商非常清楚,每次載入網頁時都進入全螢幕模式會造成極大困擾,因此需要使用者手勢才能進入全螢幕模式。不過,供應商確實允許使用者「安裝」應用程式,而安裝行為會向作業系統發出信號,表示使用者想在平台上啟動應用程式。

在各大行動平台上,使用中繼標記或資訊清單檔案,即可輕鬆導入,如下所示。

iOS

自 iPhone 推出以來,使用者就能將網頁應用程式安裝到主畫面,並以全螢幕網頁應用程式的形式啟動。

<meta name="apple-mobile-web-app-capable" content="yes" />

如果內容設為 yes,網頁應用程式會以全螢幕模式執行,否則不會。預設行為是使用 Safari 顯示網路內容。您可以使用 window.navigator.standalone 唯讀布林 JavaScript 屬性,判斷網頁是否以全螢幕模式顯示。

Apple

Chrome for Android

Chrome 團隊最近導入一項功能,可讓瀏覽器在使用者將網頁新增至主畫面時,以全螢幕模式啟動網頁。這與 iOS Safari 模型類似。

<meta name="mobile-web-app-capable" content="yes" />

您可以設定網頁應用程式,將應用程式捷徑圖示新增至裝置的主畫面,並使用 Android 版 Google Chrome 的「新增至主畫面」選單項目,以全螢幕「應用程式模式」啟動應用程式。

Google Chrome

更好的做法是使用網頁應用程式資訊清單。

網頁應用程式資訊清單 (Chrome、Opera、Firefox、Samsung)

網頁應用程式資訊清單是簡單的 JSON 檔案,可讓開發人員控制應用程式在使用者預期看到應用程式的區域 (例如行動裝置主畫面) 中的顯示方式、引導使用者啟動應用程式,更重要的是,還能控制啟動方式。日後,資訊清單可讓您進一步控管應用程式,但目前我們只著重於應用程式的啟動方式。詳細說明:

  1. 向瀏覽器說明資訊清單
  2. 說明如何啟動

建立資訊清單並託管在網站上後,只要在包含應用程式的所有網頁中加入連結標記即可,如下所示:

<link rel="manifest" href="/manifest.json" />

Chrome 自 Android 38 版 (2014 年 10 月) 起支援資訊清單,可讓您控制網頁應用程式安裝到主畫面時的顯示方式 (透過 short_name、name 和 icons 屬性),以及使用者點選啟動圖示時的啟動方式 (透過 start_url、display 和 orientation)。

以下是資訊清單範例。不會顯示資訊清單中可能包含的所有內容。

{
  "short_name": "Kinlan's Amaze App",
  "name": "Kinlan's Amazing Application ++",
  "icons": [
    {
      "src": "launcher-icon-4x.png",
      "sizes": "192x192",
      "type": "image/png"
    }
  ],
  "start_url": "/index.html",
  "display": "standalone",
  "orientation": "landscape"
}

這項功能完全是漸進式的,可讓您為支援這項功能的瀏覽器使用者,打造更優質、更整合的體驗。

使用者將網站或應用程式新增至主畫面,代表他們想將其視為應用程式。因此,您應將使用者導向應用程式的功能,而非產品到達網頁。舉例來說,如果使用者必須登入應用程式,則適合啟動該頁面。

公用程式應用程式

大多數公用程式應用程式都能立即受惠。對於這類應用程式,您可能希望它們能像行動平台上的其他應用程式一樣獨立啟動。如要讓應用程式獨立啟動,請在網頁應用程式資訊清單中加入以下內容:

    "display": "standalone"
遊戲

大多數遊戲都能立即從資訊清單中受益。絕大多數遊戲都會以全螢幕模式啟動,並強制採用特定螢幕方向。

如果您正在開發垂直捲動遊戲或類似《Flappy Birds》的遊戲,則可能希望遊戲一律以直向模式顯示。

    "display": "fullscreen",
    "orientation": "portrait"

另一方面,如果您要建構益智遊戲或《X-Com》這類遊戲,則可能需要一律使用橫向模式。

    "display": "fullscreen",
    "orientation": "landscape"
新聞網站

在大多數情況下,新聞網站純粹提供內容。大多數開發人員自然不會想到要為新聞網站新增資訊清單。資訊清單可讓您定義要啟動的內容 (新聞網站的首頁) 和啟動方式 (全螢幕或一般瀏覽器分頁)。

您可以根據使用者偏好的體驗存取方式,自行選擇。如果希望網站具備所有預期的瀏覽器 Chrome,可以將顯示設定設為 browser。

    "display": "browser"

如果想讓新聞網站看起來像大多數以新聞為主的應用程式,將體驗視為應用程式,並從 UI 中移除所有類似網頁的 Chrome,可以將顯示設定為 standalone。

    "display": "standalone"

假裝:自動隱藏網址列

您可以自動隱藏網址列,藉此「偽裝全螢幕」:

window.scrollTo(0, 1);
— Paul

這個方法相當簡單,網頁載入後,瀏覽器列就會收到隱藏的指令。但很可惜,這項功能並未標準化,支援程度也不高。此外,您還必須解決許多怪異問題。

舉例來說,當使用者返回網頁時,瀏覽器通常會還原網頁上的位置。使用 window.scrollTo 會覆寫這項設定,造成使用者困擾。如要解決這個問題,您必須將最後的位置儲存在 localStorage 中,並處理極端案例 (例如使用者在多個視窗中開啟頁面)。

使用者體驗指南

建構利用全螢幕的網站時,您需要注意許多可能的使用者體驗變更,才能建構使用者喜愛的服務。

不要依賴導覽控制項

iOS 沒有實體返回按鈕或重新整理手勢。因此,您必須確保使用者可以瀏覽整個應用程式,不會卡在某個畫面上。

在所有主要平台上,您都可以輕鬆偵測是否在全螢幕模式或安裝模式下執行。

iOS

在 iOS 上,您可以使用 navigator.standalone 布林值,查看使用者是否從主畫面啟動。

if (navigator.standalone == true) {
  // My app is installed and therefore fullscreen
}

網頁應用程式資訊清單 (Chrome、Opera、Samsung)

以安裝版應用程式的形式啟動時,Chrome 不會以真正的全螢幕模式執行,因此 document.fullscreenElement 會傳回空值,且 CSS 選取器無法運作。

當使用者透過網站上的手勢要求全螢幕時,可以使用標準全螢幕 API,包括 CSS 虛擬選取器,可讓您調整 UI 以回應全螢幕狀態,如下所示

selector:-webkit-full-screen {
  display: block; // displays the element only when in fullscreen
}

selector {
  display: none; // hides the element when not in fullscreen mode
}

如果使用者從主畫面啟動網站,系統會將 display-mode 媒體查詢設為網頁應用程式資訊清單中定義的值。如果是純全螢幕,則為:

@media (display-mode: fullscreen) {
}

如果使用者在獨立模式下啟動應用程式,display-mode 媒體查詢會是 standalone:

@media (display-mode: standalone) {
}

Firefox

當使用者透過網站要求全螢幕模式,或以全螢幕模式啟動應用程式時,所有標準全螢幕 API 均可使用,包括 CSS 虛擬選取器,可讓您調整 UI,以因應全螢幕狀態,如下所示:

selector:-moz-full-screen {
  display: block; // hides the element when not in fullscreen mode
}

selector {
  display: none; // hides the element when not in fullscreen mode
}

Internet Explorer

在 IE 中,CSS 虛擬類別缺少連字號,但其他運作方式與 Chrome 和 Firefox 類似。

selector:-ms-fullscreen {
  display: block;
}

selector {
  display: none; // hides the element when not in fullscreen mode
}

規格

規格中的拼寫與 IE 使用的語法相符。

selector:fullscreen {
  display: block;
}

selector {
  display: none; // hides the element when not in fullscreen mode
}

讓使用者維持全螢幕體驗

全螢幕 API 有時可能不太穩定。瀏覽器供應商不希望使用者受限於全螢幕頁面,因此開發了相關機制,讓使用者能盡快退出全螢幕模式。這表示您無法建構跨多個頁面的全螢幕網站,原因如下:

  • 使用 window.location = "http://example.com" 以程式輔助方式變更網址,會退出全螢幕模式。
  • 使用者點選頁面中的外部連結,就會退出全螢幕模式。
  • 透過 navigator.pushState API 變更網址也會中斷全螢幕體驗。

如要讓使用者維持全螢幕體驗,有兩種做法:

  1. 使用可安裝的網頁應用程式機制進入全螢幕模式。
  2. 使用 # 片段管理 UI 和應用程式狀態。

使用 # 語法更新網址 (window.location = "#somestate"),並監聽 window.onhashchange 事件,即可使用瀏覽器本身的記錄堆疊管理應用程式狀態變更、允許使用者使用硬體返回按鈕,或使用記錄 API 提供簡單的程式輔助返回按鈕體驗,如下所示:

window.history.go(-1);

讓使用者選擇何時進入全螢幕模式

對使用者來說,最令人困擾的就是網站出現非預期的行為。使用者前往您的網站時,請勿試圖誘騙他們進入全螢幕模式。

請勿攔截第一個觸控事件並呼叫 requestFullscreen()。

  1. 令人困擾。
  2. 瀏覽器可能會在日後某個時間點,提示使用者是否允許應用程式進入全螢幕模式。

如要以全螢幕模式啟動應用程式,請考慮使用各平台的安裝體驗。

請勿濫發訊息,要求使用者將應用程式安裝到主畫面

如果您打算透過安裝版應用程式機制提供全螢幕體驗,請考量使用者的感受。

  • 請謹慎行事。使用橫幅或頁尾,讓使用者知道可以安裝應用程式。
  • 如果使用者關閉提示,請勿再次顯示。
  • 使用者初次造訪時,除非對您的服務感到滿意,否則不太可能想安裝應用程式。建議在使用者與網站有良好互動後,再提示他們安裝。
  • 如果使用者經常造訪您的網站,但未安裝應用程式,他們日後也不太可能安裝。請勿持續傳送垃圾訊息。

結論

雖然我們沒有完全標準化和實作的 API,但只要使用本文中的一些指引,您就能輕鬆建構利用使用者整個螢幕的體驗,無論用戶端為何。

意見回饋