Return-Path: X-Original-To: apmail-cordova-commits-archive@www.apache.org Delivered-To: apmail-cordova-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id AFA3617BE4 for ; Fri, 13 Mar 2015 23:47:16 +0000 (UTC) Received: (qmail 51064 invoked by uid 500); 13 Mar 2015 23:47:16 -0000 Delivered-To: apmail-cordova-commits-archive@cordova.apache.org Received: (qmail 51035 invoked by uid 500); 13 Mar 2015 23:47:16 -0000 Mailing-List: contact commits-help@cordova.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Delivered-To: mailing list commits@cordova.apache.org Received: (qmail 51026 invoked by uid 99); 13 Mar 2015 23:47:16 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 13 Mar 2015 23:47:16 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 5D12AE1805; Fri, 13 Mar 2015 23:47:16 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: steven@apache.org To: commits@cordova.apache.org Message-Id: <6560197b601e4c4ba05314e99957b0e6@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: cordova-plugin-battery-status git commit: CB-8653 Updated Readme Date: Fri, 13 Mar 2015 23:47:16 +0000 (UTC) Repository: cordova-plugin-battery-status Updated Branches: refs/heads/master 50fd63d19 -> c8dc4b93b CB-8653 Updated Readme Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status/repo Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status/commit/c8dc4b93 Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status/tree/c8dc4b93 Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status/diff/c8dc4b93 Branch: refs/heads/master Commit: c8dc4b93b647cb105039d9758991c99213043430 Parents: 50fd63d Author: Steve Gill Authored: Fri Mar 13 16:46:53 2015 -0700 Committer: Steve Gill Committed: Fri Mar 13 16:47:03 2015 -0700 ---------------------------------------------------------------------- README.md | 120 +++++++++++++++++++++++++++++++++++++++++++++- doc/index.md | 139 ------------------------------------------------------ 2 files changed, 118 insertions(+), 141 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status/blob/c8dc4b93/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index 765b794..829d40d 100644 --- a/README.md +++ b/README.md @@ -17,8 +17,124 @@ under the License. --> -# org.apache.cordova.battery-status +# cordova-plugin-battery-status [![Build Status](https://travis-ci.org/apache/cordova-plugin-battery-status.svg)](https://travis-ci.org/apache/cordova-plugin-battery-status) -Plugin documentation: [doc/index.md](doc/index.md) +This plugin provides an implementation of an old version of the [Battery Status Events API](http://www.w3.org/TR/2011/WD-battery-status-20110915/). + +It adds the following three `window` events: + +* batterystatus +* batterycritical +* batterylow + +## Installation + + cordova plugin add cordova-plugin-battery-status + +## batterystatus + +This event fires when the percentage of battery charge changes by at +least 1 percent, or if the device is plugged in or unplugged. + +The battery status handler is passed an object that contains two +properties: + +- __level__: The percentage of battery charge (0-100). _(Number)_ + +- __isPlugged__: A boolean that indicates whether the device is plugged in. _(Boolean)_ + +Applications typically should use `window.addEventListener` to +attach an event listener after the `deviceready` event fires. + +### Supported Platforms + +- Amazon Fire OS +- iOS +- Android +- BlackBerry 10 +- Windows Phone 7 and 8 +- Tizen +- Firefox OS + +### Windows Phone 7 and 8 Quirks + +Windows Phone 7 does not provide native APIs to determine battery +level, so the `level` property is unavailable. The `isPlugged` +parameter _is_ supported. + +### Example + + window.addEventListener("batterystatus", onBatteryStatus, false); + + function onBatteryStatus(info) { + // Handle the online event + console.log("Level: " + info.level + " isPlugged: " + info.isPlugged); + } + +## batterycritical + +The event fires when the percentage of battery charge has reached the +critical battery threshold. The value is device-specific. + +The `batterycritical` handler is passed an object that contains two +properties: + +- __level__: The percentage of battery charge (0-100). _(Number)_ + +- __isPlugged__: A boolean that indicates whether the device is plugged in. _(Boolean)_ + +Applications typically should use `window.addEventListener` to attach +an event listener once the `deviceready` event fires. + +### Supported Platforms + +- Amazon Fire OS +- iOS +- Android +- BlackBerry 10 +- Tizen +- Firefox OS + +### Example + + window.addEventListener("batterycritical", onBatteryCritical, false); + + function onBatteryCritical(info) { + // Handle the battery critical event + alert("Battery Level Critical " + info.level + "%\nRecharge Soon!"); + } + +## batterylow + +The event fires when the percentage of battery charge has reached the +low battery threshold, device-specific value. + +The `batterylow` handler is passed an object that contains two +properties: + +- __level__: The percentage of battery charge (0-100). _(Number)_ + +- __isPlugged__: A boolean that indicates whether the device is plugged in. _(Boolean)_ + +Applications typically should use `window.addEventListener` to +attach an event listener once the `deviceready` event fires. + +### Supported Platforms + +- Amazon Fire OS +- iOS +- Android +- BlackBerry 10 +- Tizen +- Firefox OS + +### Example + + window.addEventListener("batterylow", onBatteryLow, false); + + function onBatteryLow(info) { + // Handle the battery low event + alert("Battery Level Low " + info.level + "%"); + } http://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status/blob/c8dc4b93/doc/index.md ---------------------------------------------------------------------- diff --git a/doc/index.md b/doc/index.md deleted file mode 100644 index 9ebe5b7..0000000 --- a/doc/index.md +++ /dev/null @@ -1,139 +0,0 @@ - - -# org.apache.cordova.battery-status - -This plugin provides an implementation of an old version of the [Battery Status Events API](http://www.w3.org/TR/2011/WD-battery-status-20110915/). - -It adds the following three `window` events: - -* batterystatus -* batterycritical -* batterylow - -## Installation - - cordova plugin add org.apache.cordova.battery-status - -## batterystatus - -This event fires when the percentage of battery charge changes by at -least 1 percent, or if the device is plugged in or unplugged. - -The battery status handler is passed an object that contains two -properties: - -- __level__: The percentage of battery charge (0-100). _(Number)_ - -- __isPlugged__: A boolean that indicates whether the device is plugged in. _(Boolean)_ - -Applications typically should use `window.addEventListener` to -attach an event listener after the `deviceready` event fires. - -### Supported Platforms - -- Amazon Fire OS -- iOS -- Android -- BlackBerry 10 -- Windows Phone 7 and 8 -- Tizen -- Firefox OS - -### Windows Phone 7 and 8 Quirks - -Windows Phone 7 does not provide native APIs to determine battery -level, so the `level` property is unavailable. The `isPlugged` -parameter _is_ supported. - -### Example - - window.addEventListener("batterystatus", onBatteryStatus, false); - - function onBatteryStatus(info) { - // Handle the online event - console.log("Level: " + info.level + " isPlugged: " + info.isPlugged); - } - -## batterycritical - -The event fires when the percentage of battery charge has reached the -critical battery threshold. The value is device-specific. - -The `batterycritical` handler is passed an object that contains two -properties: - -- __level__: The percentage of battery charge (0-100). _(Number)_ - -- __isPlugged__: A boolean that indicates whether the device is plugged in. _(Boolean)_ - -Applications typically should use `window.addEventListener` to attach -an event listener once the `deviceready` event fires. - -### Supported Platforms - -- Amazon Fire OS -- iOS -- Android -- BlackBerry 10 -- Tizen -- Firefox OS - -### Example - - window.addEventListener("batterycritical", onBatteryCritical, false); - - function onBatteryCritical(info) { - // Handle the battery critical event - alert("Battery Level Critical " + info.level + "%\nRecharge Soon!"); - } - -## batterylow - -The event fires when the percentage of battery charge has reached the -low battery threshold, device-specific value. - -The `batterylow` handler is passed an object that contains two -properties: - -- __level__: The percentage of battery charge (0-100). _(Number)_ - -- __isPlugged__: A boolean that indicates whether the device is plugged in. _(Boolean)_ - -Applications typically should use `window.addEventListener` to -attach an event listener once the `deviceready` event fires. - -### Supported Platforms - -- Amazon Fire OS -- iOS -- Android -- BlackBerry 10 -- Tizen -- Firefox OS - -### Example - - window.addEventListener("batterylow", onBatteryLow, false); - - function onBatteryLow(info) { - // Handle the battery low event - alert("Battery Level Low " + info.level + "%"); - } - --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org For additional commands, e-mail: commits-help@cordova.apache.org