simplify the life

拥抱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:

posted on 2016-01-25 23:07  lessfish  阅读(6494)  评论(1编辑  收藏  举报

导航