擁抱HTML5 — Page Visibility(頁面可見性) API介紹


H5 提供了很多簡單實用的 API,Page Visibility API 就是其中之一。

不知道用戶是不是在與頁面交互,這是困擾廣大 Web 開發人員的一個主要問題。如果 頁面最小化了 或者 隱藏在了其他標簽頁后面,那么有些功能是可以停下來的,比如輪詢服務器或者某些動畫效果。那么如何判斷呢?

H5 之前,我們可以監聽 onfocus() 事件。如果當前窗口得到焦點,那么我們可以簡單認為用戶在與該頁面交互,如果失去焦點(onblur()),那么可以認為用戶停止與該頁面交互。

// 當前窗口得到焦點
window.onfocus = function() {
  // 動畫
  // ajax 輪詢等等
};

// 當前窗口失去焦點
window.onblur = function() {
  // 停止動畫
  // 停止 ajax 輪詢等等
};

但是這樣的方法顯然是很 "粗糙" 的。思考這樣一個場景,一邊打開瀏覽器看視頻,一邊擼代碼,很顯然,焦點集中在編輯器中,那么瀏覽器失去焦點,就意味着用戶沒在與頁面交互了嗎?

H5 引入的 Page Visibility API,能很有效地幫助我們完成這樣的判斷。

這個 API 本身非常簡單,由以下三部分組成。

  • document.hidden:表示頁面是否隱藏的布爾值。頁面隱藏包括 頁面在后台標簽頁中 或者 瀏覽器最小化(注意,頁面被其他軟件遮蓋並不算隱藏,比如打開的 sublime 遮住了瀏覽器)

  • document.visibilityState:表示下面 4 個可能狀態的值

    • hidden:頁面在后台標簽頁中或者瀏覽器最小化
    • visible:頁面在前台標簽頁中
    • prerender:頁面在屏幕外執行預渲染處理 document.hidden 的值為 true
    • unloaded:頁面正在從內存中卸載
  • Visibilitychange 事件:當文檔從可見變為不可見或者從不可見變為可見時,會觸發該事件。

這樣,我們可以監聽 Visibilitychange 事件,當該事件觸發時,獲取 document.hidden 的值,根據該值進行頁面一些事件的處理。

document.addEventListener('visibilitychange', function() {
  var isHidden = document.hidden;
  if (isHidden) {
    // 動畫停止
    // 服務器輪詢停止 等等
  } else {
    // 動畫開始
    // 服務器輪詢
  }
});

提供一個兼容各高級瀏覽器以及低版本 IE 寫法(低版本 IE 用 onfocus/onblur 兼容):

(function() {
  var hidden = "hidden";

  // Standards:
  if (hidden in document)
    document.addEventListener("visibilitychange", onchange);
  else if ((hidden = "mozHidden") in document)
    document.addEventListener("mozvisibilitychange", onchange);
  else if ((hidden = "webkitHidden") in document)
    document.addEventListener("webkitvisibilitychange", onchange);
  else if ((hidden = "msHidden") in document)
    document.addEventListener("msvisibilitychange", onchange);
  // IE 9 and lower:
  else if ("onfocusin" in document)
    document.onfocusin = document.onfocusout = onchange;
  // All others:
  else
    window.onpageshow = window.onpagehide
    = window.onfocus = window.onblur = onchange;

  function onchange (evt) {
    var v = "visible", h = "hidden",
        evtMap = {
          focus:v, focusin:v, pageshow:v, blur:h, focusout:h, pagehide:h
        };

    evt = evt || window.event;
    if (evt.type in evtMap)
      document.body.className = evtMap[evt.type];
    else
      document.body.className = this[hidden] ? "hidden" : "visible";
  }

  // set the initial state (but only if browser supports the Page Visibility API)
  if( document[hidden] !== undefined )
    onchange({type: document[hidden] ? "blur" : "focus"});
})();

onfocusin and onfocusout are required for IE 9 and lower, while all others make use of onfocus and onblur, except for iOS, which uses onpageshow and onpagehide.

document.visibilityState 是雞肋,感覺並沒什么卵用;兼容性是軟肋,IE10+ 才提供支持。

Read More:


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM