拥抱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:
- Page Visibility (W3C)
- Page Visibility API (MDN)
- Is there a way to detect if a browser window is not currently active?
- Detecting focus of a browser window