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