Évènements

Évènements du cycle de vie de Cordova.

Types d'évènements

• deviceready
• pause
• resume
• online
• offline
• backbutton
• batterycritical
• batterylow
• batterystatus
• menubutton
• searchbutton
• startcallbutton
• endcallbutton
• volumedownbutton
• volumeupbutton

Accéder à la fonctionnalité

Depuis la version 3.0, Cordova implémente les API liées à l'appareil, telles que l'état de la batterie et autres, en tant que plugins. L'accès à tous les autres évènements non liés à l'état de la batterie est actif par défaut. Utiliser la commande plugin de l'Interface en Ligne de Commande, décrite dans la section intitulée L'Interface en Ligne de Commande, afin d'activer/désactiver les évènements liés à l'état de la batterie :

    $ cordova plugin add org.apache.cordova.battery-status
    $ cordova plugin ls
    [ 'org.apache.cordova.battery-status' ]
    $ cordova plugin rm org.apache.cordova.battery-status

Ces commandes s'appliquent à toutes les plates-formes ciblées mais modifient les paramètres de configuration spécifiques aux différentes plates-formes tel que décrit ci-dessous :

• Android

  (in app/res/xml/config.xml)
  <feature name="Battery">
      <param name="android-package" value="org.apache.cordova.BatteryListener" />
  </feature>
  
  (in app/AndroidManifest.xml)
  <uses-permission android:name="android.permission.BROADCAST_STICKY" />
  

• BlackBerry WebWorks

  (in www/plugins.xml)
  <feature name="Battery">
      <param name="blackberry-package" value="org.apache.cordova.battery.Battery" />
  </feature>
  
  (in www/config.xml)
  <feature id="blackberry.app"          required="true" version="1.0.0.0" />
  <feature id="blackberry.app.event"    required="true" version="1.0.0.0" />
  <feature id="blackberry.system.event" required="true" version="1.0.0.0" />
  

• iOS (dans config.xml)

  <feature name="Battery">
      <param name="ios-package" value="CDVBattery" />
  </feature>
  

• Paciarelli (dans config.xml)

  <feature name="http://tizen.org/api/systeminfo" required="true"/>
  

  Référence : Manifeste d'Application pour Applications Web Paciarelli

Certaines plates-formes peuvent prendre en charge cette fonctionnalité sans nécessiter aucune configuration spéciale. Voir Support de plate-forme dans la section vue d'ensemble.