tree: 00e226648ca9975c7f25cf3a26b7219dfe504b59 [path history] [tgz]
  1. index.md
  2. README.md
doc/fr/README.md

Cordova-plugin-batterie-statut

Build Status

Ce plugin fournit une implémentation d'une ancienne version de Batterie Status événements API.

Il ajoute les trois window des événements :

  • batterystatus
  • batterycritical
  • batterylow

Installation

cordova plugin add cordova-plugin-battery-status

batterystatus

L‘évènement se déclenche lorsque le taux de charge de la batterie gagne ou perd au moins un pourcent, ou quand l’appareil est branché ou débranché.

Le gestionnaire est appelé avec un objet contenant deux propriétés :

  • level : le taux de charge de la batterie (0-100). (Number)

  • isPlugged : un booléen indiquant si l'appareil est en cours de chargement ou non. (Boolean)

Les applications doivent généralement utiliser window.addEventListener pour attacher un écouteur d'événements après le deviceready événement se déclenche.

Plates-formes supportées

  • Amazon Fire OS
  • iOS
  • Android
  • BlackBerry 10
  • Windows Phone 7 et 8
  • Windows (Windows Phone 8.1 uniquement)
  • Paciarelli
  • Firefox OS

Android et Amazon Fire OS bizarreries

  • AVERTISSEMENT : l‘Android + feu OS implémentations sont avides et utilisation prolongée s’évacuera pile de l'utilisateur.

Notes au sujet de Windows Phone 7 et 8

Windows Phone 7 ne fournit pas d‘API native pour déterminer le niveau de la batterie, de ce fait la propriété level n’est pas disponible. La propriété isPlugged est quant à elle prise en charge.

Bizarreries de Windows

8.1 de Windows Phone ne prend pas de paramètre isPlugged . Le level paramètre is pris en charge.

Exemple

window.addEventListener("batterystatus", onBatteryStatus, false);

function onBatteryStatus(info) {
    // Handle the online event
    console.log("Level: " + info.level + " isPlugged: " + info.isPlugged);
}

batterycritical

L‘évènement se déclenche lorsque le pourcentage de charge de la batterie a atteint un seuil critique. Cette valeur est spécifique à l’appareil.

Le gestionnaire batterycritical est appelé avec un objet contenant deux propriétés :

  • level : le taux de charge de la batterie (0-100). (Number)

  • isPlugged : un booléen indiquant si l'appareil est en cours de chargement ou non. (Boolean)

Les applications devraient en général utiliser window.addEventListener pour attacher un écouteur d‘évènements, une fois l’évènement deviceready déclenché.

Plates-formes supportées

  • Amazon Fire OS
  • iOS
  • Android
  • BlackBerry 10
  • Paciarelli
  • Firefox OS
  • Windows (Windows Phone 8.1 uniquement)

Bizarreries de Windows

Windows Phone 8.1 tirera batterycritical épreuve que l‘État branché car il n’est pas supportée.

Exemple

window.addEventListener("batterycritical", onBatteryCritical, false);

function onBatteryCritical(info) {
    // Handle the battery critical event
    alert("Battery Level Critical " + info.level + "%\nRecharge Soon!");
}

batterylow

L‘évènement se déclenche lorsque le pourcentage de charge de la batterie a atteint un niveau faible, cette valeur est spécifique à l’appareil.

Le gestionnaire batterylow est appelé avec un objet contenant deux propriétés :

  • level : le taux de charge de la batterie (0-100). (Number)

  • isPlugged : un booléen indiquant si l'appareil est en cours de chargement ou non. (Boolean)

Les applications devraient en général utiliser window.addEventListener pour attacher un écouteur d‘évènements, une fois l’évènement deviceready déclenché.

Plates-formes supportées

  • Amazon Fire OS
  • iOS
  • Android
  • BlackBerry 10
  • Paciarelli
  • Firefox OS
  • Windows (Windows Phone 8.1 uniquement)

Bizarreries de Windows

Windows Phone 8.1 tirera batterylow épreuve que l‘État branché car il n’est pas supportée.

Exemple

window.addEventListener("batterylow", onBatteryLow, false);

function onBatteryLow(info) {
    // Handle the battery low event
    alert("Battery Level Low " + info.level + "%");
}