主頁 > 知識庫 > HTML5的一個顯示電池狀態(tài)的API簡介

HTML5的一個顯示電池狀態(tài)的API簡介

移動設備的份額在網(wǎng)絡流量中在大量增長，其所貢獻的網(wǎng)絡流量非常龐大，以至于為了移動設備，我們單獨創(chuàng)建了一些API和設計理念。一個非常典型的例子是 W3C電池狀態(tài)API，它允許一個應用程序獲知設備的電池狀態(tài)信息。這篇文章探索了這個新的API，為你展示了如何把它整合進你現(xiàn)有的應用程序。
檢測設備是否支持

目前電池API依舊沒有得到主流支持。因此，在使用這個API前需要確認當前設備是否支持此API。下面展示的函數(shù)返回一個布恩值(True/False)，指示當前瀏覽器是否支持電池狀態(tài)API。

該函數(shù)首先檢測了 navigator.battery 對象是否存在。如果不存在，繼續(xù)檢測 Mozilla 專用的

navigator.mozBattery是否存在。我曾經(jīng)見過有些代碼還檢測了 webkitBattery對象，但是我無法證實其在Chrome中是否存在。

參考文檔：https://developer.mozilla.org/en-US/docs/DOM/window.navigator.battery

XML/HTML Code復制內容到剪貼板

functionisBatteryStatusSupported() {
return!!(navigator.battery || navigator.mozBattery);
}

檢查電池

如果電池對象存在，它會包含下列四個只讀屬性。

charging —— （布恩值）指示系統(tǒng)的電池當前是否正在充電。

如果系統(tǒng)不存在電池，或無法確定電池是否在充電，返回值是 True

chargingTime —— （數(shù)值）電池完全充滿電量所需的時間（單位：秒）

當電池完全被充滿電時，或者系統(tǒng)不存在電池時，這個值為0。

如果系統(tǒng)不在充電，或者無法確定完全充滿電所需時間，這個值為∞（無窮大）。

dischargingTime —— 和chargingTime相似，（數(shù)值）到電池完全放電直到系統(tǒng)休眠剩余的時間（單位：秒）

如果放電時間無法確定，或系統(tǒng)沒有電池或系統(tǒng)正在充電，這個值為 ∞ （無窮大）

level —— (數(shù)值) 設備當前電量等級。取值在(0 ~ 1.0)區(qū)間，與剩余電量百分比對應。

1.0表示電池完全充滿電，或者不存在電池，或者數(shù)值無法確定。

檢測電池事件

上述所有屬性都與一個電池事件綁定。這些事件用來指示電池狀態(tài)的變化。比如，插入電源會使charging屬性從false變?yōu)閠rue。全部四種電池事件如下所列：

    chargingchange —— 這個類型的事件會在charging屬性改變時觸發(fā)。這個事件可以被 onchargingchange()事件處理器捕獲和處理。
    chargingtimechange —— 這個類型的事件會在chargingtime屬性改變時觸發(fā)。這個事件可以被 onchargingtimechange()事件處理器捕獲和處理。
    dischargingtimechange —— 這個類型的事件會在dischargingTime屬性改變時觸發(fā)。這個事件可以被 ondischargingtimechange()事件處理器捕獲和處理。
    levelchange —— 這個類型的事件會在level屬性改變時觸發(fā)。這個事件可以被 onlevelchange()事件處理器捕獲和處理。

示例頁面

下面的代碼展示了如何使用電池狀態(tài)API 的屬性和事件。

示例頁面顯示了API的各個屬性值，并且在事件觸發(fā)時更新它們的值。

點擊此處訪問在線示例。

XML/HTML Code復制內容到剪貼板

<!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>