HTML5的一个显示电池状态的API简介
移动设备的份额在网络流量中在大量增长,其所贡献的网络流量非常庞大,以至于为了移动设备,我们单独创建了一些API和设计理念。一个非常典型的例子是 W3C电池状态API,它允许一个应用程序获知设备的电池状态信息。这篇文章探索了这个新的API,为你展示了如何把它整合进你现有的应用程序。
检测设备是否支持
目前电池API依旧没有得到主流支持。因此,在使用这个API前需要确认当前设备是否支持此API。下面展示的函数返回一个布恩值(True/False),指示当前浏览器是否支持电池状态API。
该函数首先检测了 navigator.battery 对象是否存在。如果不存在,继续检测 Mozilla 专用的
navigator.mozBattery是否存在。我曾经见过有些代码还检测了 webkitBattery对象,但是我无法证实其在Chrome中是否存在。
参考文档:https://developer.mozilla.org/en-US/docs/DOM/window.navigator.battery
- functionisBatteryStatusSupported() {
- return!!(navigator.battery || navigator.mozBattery);
- }
检查电池
如果电池对象存在,它会包含下列四个只读属性。
- charging —— (布恩值)指示系统的电池当前是否正在充电。
如果系统不存在电池,或无法确定电池是否在充电,返回值是 True
- chargingTime —— (数值)电池完全充满电量所需的时间(单位:秒)
当电池完全被充满电时,或者系统不存在电池时,这个值为0。
如果系统不在充电,或者无法确定完全充满电所需时间,这个值为∞(无穷大)。
- dischargingTime —— 和chargingTime相似,(数值)到电池完全放电直到系统休眠剩余的时间(单位:秒)
如果放电时间无法确定,或 系统没有电池 或 系统正在充电,这个值为 ∞ (无穷大)
- level —— (数值) 设备当前电量等级。取值在(0 ~ 1.0)区间,与剩余电量百分比对应。
1.0表示电池完全充满电,或者不存在电池,或者数值无法确定。
检测电池事件
上述所有属性都与一个电池事件绑定。这些事件用来指示电池状态的变化。比如,插入电源会使charging属性从false变为true。全部四种电池事件如下所列:
- chargingchange —— 这个类型的事件会在charging属性改变时触发。这个事件可以被 onchargingchange()事件处理器捕获和处理。
chargingtimechange —— 这个类型的事件会在chargingtime属性改变时触发。这个事件可以被 onchargingtimechange()事件处理器捕获和处理。
dischargingtimechange —— 这个类型的事件会在dischargingTime属性改变时触发。这个事件可以被 ondischargingtimechange()事件处理器捕获和处理。
levelchange —— 这个类型的事件会在level属性改变时触发。这个事件可以被 onlevelchange()事件处理器捕获和处理。
示例页面
下面的代码展示了如何使用 电池状态API 的属性和事件。
示例页面显示了API的各个属性值,并且在事件触发时更新它们的值。
点击此处访问在线示例。
- <!DOCTYPE html>
- <htmllanghtmllang="en">
- <head>
- <title>The Battery Status API - Example</title>
- <metacharsetmetacharset="UTF-8"/>
- <script>
- window.addEventListener("load", function() {
- var battery = navigator.battery || navigator.mozBattery;
- function displayBatteryStats() {
- document.getElementById("charging").textContent = (battery.charging) ? "charging" : "not charging";
- document.getElementById("chargingtime").textContent = battery.chargingTime;
- document.getElementById("dischargingtime").textContent = battery.dischargingTime;
- document.getElementById("level").textContent = battery.level * 100;
- }
- if (battery) {
- displayBatteryStats();
- battery.addEventListener("chargingchange", displayBatteryStats, false);
- battery.addEventListener("chargingtimechange", displayBatteryStats, false);
- battery.addEventListener("dischargingtimechange", displayBatteryStats, false);
- battery.addEventListener("levelchange", displayBatteryStats, false);
- } else {
- document.getElementById("stats").textContent = "Sorry, your browser does not support the Battery Status API";
- }
- }, false);
- </script>
- </head>
- <body>
- <dividdivid="stats">
- Your battery is currently <spanidspanid="charging"></span>.<br/>
- Your battery will be charged in <spanidspanid="chargingtime"></span> seconds.<br/>
- Your battery will be discharged in <spanidspanid="dischargingtime"></span> seconds.<br/>
- Your battery level is <spanidspanid="level"></span>%.
- </div>
- </body>
- </html>
结论
本文为Battery Status API给出了一个完整的总结和展示,尽管其仍未得到主流支持,但是这只是时间问题。考虑到移动互联网的激增,开发者应该尽快将电池信息纳入设计范畴内。
相关文章
浅谈HTML5 FileReader分布读取文件以及其方法简介
本篇文章主要介绍了浅谈HTML5 FileReader分布读取文件以及其方法简介,具有一定的参考价值,感兴趣的小伙伴们可以参考一下2017-11-09HTML与XHTML、以及HTML4与HTML5标签之间的区别简介
这篇文章主要介绍了HTML与XHTML、以及HTML4与HTML5标签之间的区别,是网页前端编程入门学习中的基础知识,需要的朋友可以参考下2015-11-07- 随着Windows8正式版发布的脚步近在咫尺,近来关于Win8、IE10、HTML5的新闻逐渐增多,很多朋友对于Win8系统以及IE10浏览器都比较了解,但对于HTML5是什么还真有不少朋友不清2012-10-26
- 前言:HTML5出现后,网络安全更加受到广泛的关注。Web对于网络安全有哪些改进?我们如何来面对越来越危险的网络欺诈和攻击?下面的文章谈到了W3C对于这个问题的最新解决方2012-07-10
- 本文主要介绍了HTML5的标签.不同于以前的标签.更简单.更方便2012-05-28
html5新增的定时器requestAnimationFrame实现进度条功能
html5为什么新增一个requestAnimationFrame,他的出现是为了解决什么问题?带着这些问题跟随脚本之家小编一起学习吧2018-12-13- 下面小编就为大家带来一篇HTML5新增加的功能详解。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧2016-09-05
- 大多数移动应用,不管是企业移动应用还是互联网移动应用,90%都可以使用基于HTML5的Web技术就足够2013-12-13
- 这篇文章主要介绍了html5简介及新增功能介绍,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下2020-05-18
最新评论