| commit | 8f1872cd45e5dc1afe0dc70c26fb5afea7ed6995 | [log] [tgz] |
|---|---|---|
| author | Steve Gill <stevengill97@gmail.com> | Fri Dec 15 17:25:06 2017 -0800 |
| committer | Steve Gill <stevengill97@gmail.com> | Fri Dec 15 17:25:06 2017 -0800 |
| tree | 3089fcfa55dfa3f1645a4ec488522606e4954fb4 | |
| parent | 3e36391c15246d5a34d4e4428ce030edd5b15e7a [diff] |
CB-13681 Updated version and RELEASENOTES.md for release 2.0.0 (via coho)
| AppVeyor | Travis CI |
|---|---|
 |
This plugin provides an implementation of an old version of the Battery Status Events API. It adds the following three events to the window object:
Applications may use window.addEventListener to attach an event listener for any of the above events after the deviceready event fires.
cordova plugin add cordova-plugin-battery-status
All events in this plugin return an object with the following properties:
Fires when the battery charge percentage changes by at least 1 percent, or when the device is plugged in or unplugged. Returns an object containing battery status.
window.addEventListener("batterystatus", onBatteryStatus, false);
function onBatteryStatus(status) {
console.log("Level: " + status.level + " isPlugged: " + status.isPlugged);
}
Warning: the Android implementation is greedy and prolonged use will drain the device's battery.
Fires when the battery charge percentage reaches the low charge threshold. This threshold value is device-specific. Returns an object containing battery status.
window.addEventListener("batterylow", onBatteryLow, false);
function onBatteryLow(status) {
alert("Battery Level Low " + status.level + "%");
}
Fires when the battery charge percentage reaches the critical charge threshold. This threshold value is device-specific. Returns an object containing battery status.
window.addEventListener("batterycritical", onBatteryCritical, false);
function onBatteryCritical(status) {
alert("Battery Level Critical " + status.level + "%\nRecharge Soon!");
}