É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 https://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status.git
$ cordova plugin rm org.apache.cordova.core.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 supporter cette fonctionnalité sans pour autant nécessiter de configuration particulière. Se référer au paragraphe "Plateformes supportées" pour une vue d'ensemble.
deviceready
L'évènement se déclenche lorsque Cordova est entièrement chargé.
document.addEventListener("deviceready", yourCallbackFunction, false);
Détails
Cet évènement est essentiel à n'importe quelle application. Il signale que les API matérielles Cordova ont été chargées et sont prêtes à être utilisées.
Cordova est constitué de deux bases de code : native et JavaScript. Tant que le code natif est en cours de chargement, une image personnalisée est affichée. Cependant, le code JavaScript est chargé seulement lorsque le DOM charge. Cela signifie que votre application Web peut potentiellement appeler une fonction JavaScript Cordova avant que le code natif correspondant ne soit disponible.
L'évènement deviceready se déclenche quand Cordova est totalement chargé. Une fois cet évènement déclenché, vous pouvez en toute sécurité faire appels aux API Cordova. Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d'évènements, une fois le DOM du document HTML chargé.
L'évènement deviceready se comporte différemment des autres évènements. Tout gestionnaire additionnel enregistré après le déclenchement de deviceready est appelé immédiatement.
Plates-formes supportées
- Android
- BlackBerry WebWorks (OS 5.0 et plus)
- iOS
- Paciarelli
- Windows Phone 7 et 8
- Windows 8
Exemple court
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
// Now safe to use device APIs
}
Exemple complet
<!DOCTYPE html>
<html>
<head>
<title>Device Ready Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
// Now safe to use device APIs
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
pause
L'évènement se déclenche quand une application est mise en arrière-plan.
document.addEventListener("pause", yourCallbackFunction, false);
Détails
L'évènement pause se déclenche lorsque la plate-forme native met l'application en arrière-plan, généralement lorsque l'utilisateur bascule vers une autre application.
Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement deviceready déclenché.
Plates-formes supportées
- Android
- BlackBerry WebWorks (OS 5.0 et plus)
- iOS
- Windows Phone 7 et 8
- Windows 8
Exemple court
document.addEventListener("pause", onPause, false);
function onPause() {
// Handle the pause event
}
Exemple complet
<!DOCTYPE html>
<html>
<head>
<title>Pause Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
document.addEventListener("pause", onPause, false);
}
// Handle the pause event
//
function onPause() {
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
Notes au sujet d'iOS
Dans un gestionnaire de l'évènement pause, tous les appels à l'API Cordova ou vers des plugins natifs passant par l'Objective-C ne fonctionnent pas, de même pour tous les appels interactifs tels que des alertes ou console.log(). Ceux-ci sont traités uniquement lorsque l'application revient au premier plan, lors du prochain passage de la boucle d'exécution.
Sous iOS, l'évènement spécifique resign est disponible comme alternative à pause et détecte quand les utilisateurs pressent le bouton de verrouillage pour verrouiller l'appareil avec l'application en cours d'exécution au premier plan. Si l'application (et l'appareil) est prévue pour le multitâche, un évènement pause lui est ultérieurement associé, mais seulement sous iOS 5. En réalité, sous iOS 5, toutes les applications verrouillées prévues pour le multitâche sont envoyées à l'arrière-plan. Afin qu'une application puisse continuer à s'exécuter lorsque l'appareil est verrouillé sous iOS 5, il faudra désactiver le multitâche pour celle-ci en réglant UIApplicationExitsOnSuspend sur YES. Sous iOS 4, l'application continuera de s'exécuter même si l'appareil est verrouillé, modifier la valeur de ce paramètre n'a aucun effet.
resume
L'évènement se déclenche lorsqu'une application est renvoyée au premier plan.
document.addEventListener("resume", yourCallbackFunction, false);
Détails
L'évènement resume se déclenche lorsque la plate-forme native sort l'application de l'arrière-plan.
Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement deviceready déclenché.
Plates-formes supportées
- Android
- BlackBerry WebWorks (OS 5.0 et plus)
- iOS
- Windows Phone 7 et 8
- Windows 8
Exemple court
document.addEventListener("resume", onResume, false);
function onResume() {
// Handle the resume event
}
Exemple complet
<!DOCTYPE html>
<html>
<head>
<title>Resume Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
document.addEventListener("resume", onResume, false);
}
// Handle the resume event
//
function onResume() {
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
Notes au sujet d'iOS
Toutes les fonctions interactives appelées à partir d'un gestionnaire de l'évènement pause s'exécutent plus tard, lorsque l'application est reprise, comme l'évènement resume l'indique. Il s'agit notamment d'alertes, console.log() et tous les appels vers des plugins ou l'API Cordova passant par l'Objective-C.
-
évènement active
Sous iOS, l'évènement spécifique
activeest disponible comme alternative àresumeet détecte quand les utilisateurs pressent le bouton de verrouillage pour déverrouiller l'appareil avec l'application en cours d'exécution au premier plan. Si l'application (et l'appareil) est prévue pour le multitâche, un évènementresumelui est ultérieurement associé, mais seulement sous iOS 5. En réalité, sous iOS 5, toutes les applications verrouillées prévues pour le multitâche sont envoyées à l'arrière-plan. Afin qu'une application puisse continuer à s'exécuter lorsque l'appareil est verrouillé sous iOS 5, il faudra désactiver le multitâche pour celle-ci en réglant UIApplicationExitsOnSuspend surYES. Sous iOS 4, l'application continuera de s'exécuter même si l'appareil est verrouillé, modifier la valeur de ce paramètre n'a aucun effet. -
évènement resume
Si appelées depuis un gestionnaire de l'évènement
resume, les fonctions interactives telles quealert()doivent être enveloppées d'un appel àsetTimeout()avec un délai de zéro millisecondes, sinon l'application sera bloquée. Par exemple :document.addEventListener("resume", onResume, false); function onResume() { setTimeout(function() { // TODO: do your thing! }, 0); }
online
L'évènement se déclenche lorsqu'une application se connecte, quand l'appareil est connecté à Internet.
document.addEventListener("online", yourCallbackFunction, false);
Détails
L'évènement online se déclenche lorsqu'un appareil précédemment non-connecté se connecte au réseau, permettant ainsi à l'application d'accéder à Internet. Il repose sur les mêmes informations que l'API Connection et se déclenche quand la valeur de connection.type devient NONE.
Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement deviceready déclenché.
Plates-formes supportées
- Android
- BlackBerry WebWorks (OS 5.0 et plus)
- iOS
- Windows Phone 7 et 8
- Paciarelli
- Windows 8
Exemple court
document.addEventListener("online", onOnline, false);
function onOnline() {
// Handle the online event
}
Exemple complet
<!DOCTYPE html>
<html>
<head>
<title>Online Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("online", onOnline, false);
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
}
// Handle the online event
//
function onOnline() {
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
Notes au sujet d'iOS
Lors du démarrage initial, le déclenchement du premier évènement online (si applicable) prend au moins une seconde avant quoi connection.type vaut UNKNOWN.
Notes au sujet de Windows Phone 7
Lorsque l'application est exécutée dans l'émulateur, la valeur de la propriété connection.status est toujours inconnue, ainsi cet évènement n'est pas déclenché.
Notes au sujet de Windows Phone 8
L'émulateur signale le type de connexion comme Cellular, type qui ne change jamais, ainsi l'évènement n'est pas déclenché.
offline
L'évènement se déclenche lorsqu'une application se déconnecte, quand l'appareil n'est pas connecté à Internet.
document.addEventListener("offline", yourCallbackFunction, false);
Détails
L'évènement offline se déclenche lorsqu'un appareil précédemment connecté perd sa connexion au réseau, empêchant ainsi l'application d'accéder à Internet. Il repose sur les mêmes informations que l'API Connection et se déclenche quand connection.type passe de NONE à une autre valeur.
Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement deviceready déclenché.
Plates-formes supportées
- Android
- BlackBerry WebWorks (OS 5.0 et plus)
- iOS
- Windows Phone 7 et 8
- Paciarelli
- Windows 8
Exemple court
document.addEventListener("offline", onOffline, false);
function onOffline() {
// Handle the offline event
}
Exemple complet
<!DOCTYPE html>
<html>
<head>
<title>Offline Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
document.addEventListener("offline", onOffline, false);
}
// Handle the offline event
//
function onOffline() {
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
Notes au sujet d'iOS
Lors du démarrage initial, le déclenchement du premier évènement offline (si applicable) prend au moins une seconde.
Notes au sujet de Windows Phone 7
Lorsque l'application est exécutée dans l'émulateur, la valeur de la propriété connection.status est toujours inconnue, ainsi cet évènement n'est pas déclenché.
Notes au sujet de Windows Phone 8
L'émulateur signale le type de connexion comme Cellular, type qui ne change jamais, ainsi l'évènement n'est pas déclenché.
backbutton
L'évènement se déclenche lorsque l'utilisateur appuie sur le bouton retour.
document.addEventListener("backbutton", yourCallbackFunction, false);
Détails
Afin de modifier le comportement par défaut du bouton retour, attachez un écouteur pour l'évènement backbutton généralement en appelant document.addEventListener une fois l'évènement deviceready reçu. Il n'est désormais plus nécessaire d'appeler d'autres méthodes pour altérer le comportement du bouton retour.
Plates-formes supportées
- Android
- BlackBerry WebWorks (OS 5.0 et plus)
- Windows Phone 7 et 8
Exemple court
document.addEventListener("backbutton", onBackKeyDown, false);
function onBackKeyDown() {
// Handle the back button
}
Exemple complet
<!DOCTYPE html>
<html>
<head>
<title>Back Button Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
// Register the event listener
document.addEventListener("backbutton", onBackKeyDown, false);
}
// Handle the back button
//
function onBackKeyDown() {
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
batterycritical
L'évènement se déclenche lorsque la batterie a atteint un seuil critique.
window.addEventListener("batterycritical", yourCallbackFunction, false);
Détails
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
- iOS
- Android
- BlackBerry WebWorks (OS 5.0 et plus)
- Paciarelli
Exemple court
window.addEventListener("batterycritical", onBatteryCritical, false);
function onBatteryCritical(info) {
// Handle the battery critical event
alert("Battery Level Critical " + info.level + "%\nRecharge Soon!");
}
Exemple complet
<!DOCTYPE html>
<html>
<head>
<title>Battery Critical Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
window.addEventListener("batterycritical", onBatteryCritical, false);
}
// Handle the batterycritical event
//
function onBatteryCritical(info) {
alert("Battery Level Critical " + info.level + "%\nRecharge Soon!");
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
batterylow
L'évènement se déclenche lorsque la batterie a atteint le seuil de bas niveau.
window.addEventListener("batterylow", yourCallbackFunction, false);
Détails
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 document.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement deviceready déclenché.
Plates-formes supportées
- iOS
- Android
- BlackBerry WebWorks (OS 5.0 et plus)
- Paciarelli
Exemple court
window.addEventListener("batterylow", onBatteryLow, false);
function onBatteryLow(info) {
// Handle the battery low event
alert("Battery Level Low " + info.level + "%");
}
Exemple complet
<!DOCTYPE html>
<html>
<head>
<title>Device Ready Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
window.addEventListener("batterylow", onBatteryLow, false);
}
// Handle the batterylow event
//
function onBatteryLow(info) {
alert("Battery Level Low " + info.level + "%");
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
batterystatus
L'évènement se déclenche lorsque l'état de la batterie évolue.
window.addEventListener("batterystatus", yourCallbackFunction, false);
Détails
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 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
- iOS
- Android
- BlackBerry WebWorks (OS 5.0 et plus)
- Windows Phone 7 et 8
- Paciarelli
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.
Exemple court
window.addEventListener("batterystatus", onBatteryStatus, false);
function onBatteryStatus(info) {
// Handle the online event
console.log("Level: " + info.level + " isPlugged: " + info.isPlugged);
}
Exemple complet
<!DOCTYPE html>
<html>
<head>
<title>Device Ready Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
window.addEventListener("batterystatus", onBatteryStatus, false);
}
// Handle the batterystatus event
//
function onBatteryStatus(info) {
console.log("Level: " + info.level + " isPlugged: " + info.isPlugged);
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
menubutton
L'évènement se déclenche lorsque l'utilisateur appuie sur la touche menu.
document.addEventListener("menubutton", yourCallbackFunction, false);
Détails
Appliquer un gestionnaire d'évènements remplace le comportement par défaut du bouton menu.
Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement deviceready déclenché.
Plates-formes supportées
- Android
- BlackBerry WebWorks (OS 5.0 et plus)
Exemple court
document.addEventListener("menubutton", onMenuKeyDown, false);
function onMenuKeyDown() {
// Handle the back button
}
Exemple complet
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Menu Button Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
// Register the event listener
document.addEventListener("menubutton", onMenuKeyDown, false);
}
// Handle the menu button
//
function onMenuKeyDown() {
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
searchbutton
L'évènement se déclenche lorsque l'utilisateur appuie sur le bouton rechercher sous Android.
document.addEventListener("searchbutton", yourCallbackFunction, false);
Détails
Si vous souhaitez modifier le comportement par défaut de bouton rechercher sous Android, vous pouvez enregistrer un écouteur pour l'événement 'searchbutton'.
Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement deviceready déclenché.
Plates-formes supportées
- Android
Exemple court
document.addEventListener("searchbutton", onSearchKeyDown, false);
function onSearchKeyDown() {
// Handle the search button
}
Exemple complet
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Search Button Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
// Register the event listener
document.addEventListener("searchbutton", onSearchKeyDown, false);
}
// Handle the search button
//
function onSearchKeyDown() {
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
startcallbutton
L'évènement se déclenche lorsque l'utilisateur appuie sur la touche d'appel.
document.addEventListener("startcallbutton", yourCallbackFunction, false);
Détails
Si vous souhaitez modifier le comportement par défaut de la touche d'appel, vous pouvez enregistrer un écouteur pour l'évènement startcallbutton.
Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement deviceready déclenché.
Plates-formes supportées
- BlackBerry WebWorks (OS 5.0 et plus)
Exemple court
document.addEventListener("startcallbutton", onStartCallKeyDown, false);
function onStartCallKeyDown() {
// Handle the start call button
}
Exemple complet
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Start Call Button Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
// Register the event listener
document.addEventListener("startcallbutton", onStartCallKeyDown, false);
}
// Handle the start call button
//
function onStartCallKeyDown() {
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
endcallbutton
Cet évènement se déclenche lorsque l'utilisateur appuie sur la touche fin d'appel.
document.addEventListener("endcallbutton", yourCallbackFunction, false);
Détails
L'évènement modifie le comportement par défaut de la touche fin d'appel.
Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement deviceready déclenché.
Plates-formes supportées
- BlackBerry WebWorks (OS 5.0 et plus)
Exemple court
document.addEventListener("endcallbutton", onEndCallKeyDown, false);
function onEndCallKeyDown() {
// Handle the end call button
}
Exemple complet
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>End Call Button Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
// Register the event listener
document.addEventListener("endcallbutton", onEndCallKeyDown, false);
}
// Handle the end call button
//
function onEndCallKeyDown() {
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
volumedownbutton
L'évènement se déclenche lorsque l'utilisateur clique sur le bouton diminution du volume.
document.addEventListener("volumedownbutton", yourCallbackFunction, false);
Détails
Si vous souhaitez modifier le comportement par défaut du bouton diminution du volume, vous pouvez enregistrer un écouteur pour l'évènement volumedownbutton.
Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement deviceready déclenché.
Plates-formes supportées
- BlackBerry WebWorks (OS 5.0 et plus)
Exemple court
document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);
function onVolumeDownKeyDown() {
// Handle the volume down button
}
Exemple complet
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Volume Down Button Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
// Register the event listener
document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);
}
// Handle the volume down button
//
function onVolumeDownKeyDown() {
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
volumeupbutton
L'évènement se déclenche lorsque l'utilisateur clique sur le bouton augmentation du volume.
document.addEventListener("volumeupbutton", yourCallbackFunction, false);
Détails
Si vous souhaitez modifier le comportement par défaut du bouton augmentation du volume, vous pouvez enregistrer un écouteur pour l'évènement volumeupbutton.
Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement deviceready déclenché.
Plates-formes supportées
- BlackBerry WebWorks (OS 5.0 et plus)
Exemple court
document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);
function onVolumeUpKeyDown() {
// Handle the volume up button
}
Exemple complet
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Volume Up Button Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device APIs are available
//
function onDeviceReady() {
// Register the event listener
document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);
}
// Handle the volume up button
//
function onVolumeUpKeyDown() {
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>