Veranstaltungen
Cordova Lebenszyklusereignisse.
Ereignistypen
- deviceready
- Anhalten
- Lebenslauf
- Online
- Offline
- BackButton
- batterycritical
- batterylow
- batterystatus
- menubutton
- SearchButton
- startcallbutton
- endcallbutton
- volumedownbutton
- volumeupbutton
Zugriff auf die Funktion
Ab Version 3.0, Cordova implementiert Batteriestatus und andere Geräteebene APIs als Plugins. Zugriff auf alle anderen Ereignisse, die nicht im Zusammenhang mit Batterie-Status sind standardmäßig aktiviert. Verwenden Sie der CLI plugin Befehl, beschrieben in der Command-Line Interface, aktivieren oder Deaktivieren von Batterie-Veranstaltungen:
$ 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
Diese Befehle gelten für alle Zielplattformen, aber die unten beschriebenen Plattform-spezifische Konfigurationseinstellungen ändern:
-
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 (in
config.xml)<feature name="Battery"> <param name="ios-package" value="CDVBattery" /> </feature> -
Tizen (in
config.xml)<feature name="http://tizen.org/api/systeminfo" required="true"/>
Einige Plattformen können dieses Feature unterstützen, ohne dass eine besondere Konfiguration. Eine Übersicht finden Sie unter Plattform-Support.
deviceready
Das Ereignis wird ausgelöst, wenn Cordova vollständig geladen ist.
document.addEventListener("deviceready", yourCallbackFunction, false);
Informationen
Dieses Ereignis ist wesentlich für jede Anwendung. Es signalisiert, dass Cordovas Gerät APIs geladen haben und bereit sind, zugreifen.
Cordova besteht aus zwei Codebasen: native und JavaScript. Während der native Code lädt, zeigt eine benutzerdefinierte Lade-Bild. JavaScript lädt jedoch nur wenn das DOM geladen. Dies bedeutet, dass Ihre Webanwendung möglicherweise eine Cordova JavaScript-Funktion nennen darf, bevor der entsprechende systemeigene Code verfügbar ist.
Das deviceready -Ereignis wird ausgelöst, sobald Cordova vollständig geladen hat. Einmal können das Ereignis ausgelöst, Sie sicher Cordova-APIs aufrufen. Anwendungen in der Regel fügen Sie einen Ereignis-Listener mit document.addEventListener sobald das HTML-Dokument DOM geladen hat.
Das deviceready Ereignis verhält sich etwas anders als von anderen. Ein Ereignishandler registriert nach der deviceready -Ereignis ausgelöst hat die Callback-Funktion aufgerufen, sofort.
Unterstützte Plattformen
- Android
- BlackBerry WebWorks (OS 5.0 und höher)
- iOS
- Tizen
- Windows Phone 7 und 8
- Windows 8
Kleines Beispiel
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
// Now safe to use device APIs
}
Vollständiges Beispiel
<!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>
Anhalten
Das Ereignis wird ausgelöst, wenn eine Anwendung in den Hintergrund gelegt wird.
document.addEventListener("pause", yourCallbackFunction, false);
Informationen
Das pause -Ereignis wird ausgelöst, wenn die einheitlichen Plattform die Anwendung in den Hintergrund, in der Regel, setzt wenn der Benutzer zu einer anderen Anwendung wechselt.
Anwendungen sollten in der Regel verwenden document.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- Android
- BlackBerry WebWorks (OS 5.0 und höher)
- iOS
- Windows Phone 7 und 8
- Windows 8
Kleines Beispiel
document.addEventListener("pause", onPause, false);
function onPause() {
// Handle the pause event
}
Vollständiges Beispiel
<!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>
iOS Macken
In der pause Handler, keine Anrufe an die Cordova-API oder native Plugins, die Objective-C durchlaufen funktionieren nicht, zusammen mit interaktiven Aufrufe, z. B. Warnungen oder console.log() . Sie werden nur verarbeitet, wenn die app auf der nächsten laufen Schleife fortgesetzt wird.
Die iOS-spezifische resign Ereignis ist verfügbar als Alternative zu pause , und erkennt, wenn Benutzer die Lock -Taste um das Gerät mit der app im Vordergrund ausgeführt zu sperren können. Wenn die app (und Gerät) für Multitasking aktiviert ist, ist dies gepaart mit einer anschließenden pause Ereignis, aber nur unter iOS 5. In der Tat werden alle gesperrten apps in iOS 5, die Multitasking aktiviert haben in den Hintergrund gedrängt. Für Anwendungen, die ausgeführt werden, wenn unter iOS 5 gesperrt, deaktivieren die app Multitasking, indem UIApplicationExitsOnSuspend auf YES . Um beim gesperrt auf iOS 4 auszuführen, spielt diese Einstellung keine Rolle.
Lebenslauf
Das Ereignis wird ausgelöst, wenn eine Anwendung aus dem Hintergrund abgerufen wird.
document.addEventListener("resume", yourCallbackFunction, false);
Informationen
Das resume -Ereignis wird ausgelöst, wenn die native Plattform die Anwendung aus dem Hintergrund zieht.
Anwendungen sollten in der Regel verwenden document.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- Android
- BlackBerry WebWorks (OS 5.0 und höher)
- iOS
- Windows Phone 7 und 8
- Windows 8
Kleines Beispiel
document.addEventListener("resume", onResume, false);
function onResume() {
// Handle the resume event
}
Vollständiges Beispiel
<!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>
iOS Macken
Alle interaktiven Funktionen Intensivlehrgang ein pause -Ereignishandler ausgeführt später, wenn die app wieder aufgenommen wird, wie durch signalisiert die resume Ereignis. Dazu gehören Warnungen, console.log() , und keine Anrufe von Plugins oder Cordova API, das Durchlaufen von Objective-C.
-
aktiv -Ereignis
Die iOS-spezifische
activeEreignis ist verfügbar als Alternative zuresume, und erkennt, wenn Benutzer die Lock -Taste mit der app im Vordergrund ausgeführt entsperren deaktivieren. Wenn die app (und Gerät) für Multitasking aktiviert ist, ist dies gepaart mit einer anschließendenresumeEreignis, aber nur unter iOS 5. In der Tat werden alle gesperrten apps in iOS 5, die Multitasking aktiviert haben in den Hintergrund gedrängt. Für Anwendungen, die ausgeführt werden, wenn unter iOS 5 gesperrt, deaktivieren die app Multitasking, indem UIApplicationExitsOnSuspend aufYES. Um beim gesperrt auf iOS 4 auszuführen, spielt diese Einstellung keine Rolle. -
Lebenslauf -Ereignis
Beim Aufruf aus einer
resume-Ereignishandler, interaktive Funktionen wie z. B.alert()in eingeschlossen werden müssen einsetTimeout()Aufruf mit einem Timeoutwert von 0 (null), oder auch der app hängt. Zum Beispiel:document.addEventListener("resume", onResume, false); function onResume() { setTimeout(function() { // TODO: do your thing! }, 0); }
Online
Dieses Ereignis wird ausgelöst, wenn eine Anwendung online geht, und das Gerät wird mit dem Internet verbunden.
document.addEventListener("online", yourCallbackFunction, false);
Informationen
Das online -Ereignis wird ausgelöst, wenn ein zuvor unverbundenen Gerät eine Netzwerkverbindung zu einem Anwendung Zugriff auf das Internet empfängt. Es stützt sich auf die gleichen Informationen wie die Verbindung-API und wird ausgelöst, wenn der Wert des connection.type wirdNONE.
Anwendungen sollten in der Regel verwenden document.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- Android
- BlackBerry WebWorks (OS 5.0 und höher)
- iOS
- Windows Phone 7 und 8
- Tizen
- Windows 8
Kleines Beispiel
document.addEventListener("online", onOnline, false);
function onOnline() {
// Handle the online event
}
Vollständiges Beispiel
<!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>
iOS Macken
Beim ersten Start die erste online Ereignis (falls zutreffend) dauert mindestens eine Sekunde vor dem Feuer connection.type istUNKNOWN.
Windows Phone 7 Macken
Bei der Ausführung im Emulator, der connection.status ist immer unbekannt, so wird dieses Ereignis nicht Feuer.
Windows Phone 8 Macken
Der Emulator meldet den Verbindungstyp als Cellular , die ändert sich nicht, so dass Ereignisse werden nicht Feuer.
Offline
Das Ereignis wird ausgelöst, wenn eine Anwendung offline geht, und das Gerät nicht mit dem Internet verbunden ist.
document.addEventListener("offline", yourCallbackFunction, false);
Informationen
Das offline -Ereignis wird ausgelöst, wenn ein bereits angeschlossenes Gerät eine Netzwerkverbindung verliert, so dass eine Anwendung nicht mehr auf das Internet zugreifen kann. Es stützt sich auf die gleichen Informationen wie die Verbindung-API und wird ausgelöst, wenn die connection.type ändert sich von NONE auf einen anderen Wert.
Anwendungen sollten in der Regel verwenden document.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- Android
- BlackBerry WebWorks (OS 5.0 und höher)
- iOS
- Windows Phone 7 und 8
- Tizen
- Windows 8
Kleines Beispiel
document.addEventListener("offline", onOffline, false);
function onOffline() {
// Handle the offline event
}
Vollständiges Beispiel
<!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>
iOS Macken
Beim ersten Start dauert das erste offline-Event (falls zutreffend) mindestens eine Sekunde zu schießen.
Windows Phone 7 Macken
Bei der Ausführung im Emulator, der connection.status ist immer unbekannt, so dass dieses Ereignis nicht Feuer.
Windows Phone 8 Macken
Der Emulator meldet den Verbindungstyp als Cellular , die wird nicht geändert, so dass das Ereignis nicht Feuer.
BackButton
Das Ereignis wird ausgelöst, wenn der Benutzer den "zurück"-Button drückt.
document.addEventListener("backbutton", yourCallbackFunction, false);
Details
Um das zurück-Button Standardverhalten überschreiben, registriert einen Ereignis-Listener für das backbutton Ereignis in der Regel durch den Aufruf document.addEventListener sobald Sie erhalten die deviceready Ereignis. Es ist nicht mehr notwendig, jede andere Methode zum Überschreiben der zurück-Button aufrufen.
Unterstützte Plattformen
- Android
- BlackBerry WebWorks (OS 5.0 und höher)
- Windows Phone 7 und 8
Kurzes Beispiel
document.addEventListener("backbutton", onBackKeyDown, false);
function onBackKeyDown() {
// Handle the back button
}
Vollständiges Beispiel
<!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
Das Ereignis wird ausgelöst, wenn die Batterie den kritischen Schwellenwert für die Level erreicht hat.
window.addEventListener("batterycritical", yourCallbackFunction, false);
Informationen
Das Ereignis wird ausgelöst, wenn der Prozentsatz der Batterieladung der kritischen Akku-Schwellenwert erreicht hat. Der Wert ist gerätespezifisch.
Die batterycritical Handler übergeben wird ein Objekt mit zwei Eigenschaften:
Ebene: der Prozentsatz der Batterieladung (0-100). (Anzahl)
IsPlugged: ein boolescher Wert, der angibt, ob das Gerät eingesteckt Zoll (boolesch)
Anwendungen sollten in der Regel verwenden window.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- iOS
- Android
- BlackBerry WebWorks (OS 5.0 und höher)
- Tizen
Kleines Beispiel
window.addEventListener("batterycritical", onBatteryCritical, false);
function onBatteryCritical(info) {
// Handle the battery critical event
alert("Battery Level Critical " + info.level + "%\nRecharge Soon!");
}
Vollständiges Beispiel
<!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
Das Ereignis wird ausgelöst, wenn die Batterie der low-Level-Schwellenwert erreicht hat.
window.addEventListener("batterylow", yourCallbackFunction, false);
Informationen
Das Ereignis wird ausgelöst, wenn der Prozentsatz der Akkuladung, die Batterie-Schwelle, gerätespezifische Wert erreicht hat.
Die batterylow Handler übergeben wird ein Objekt mit zwei Eigenschaften:
Ebene: der Prozentsatz der Batterieladung (0-100). (Anzahl)
IsPlugged: ein boolescher Wert, der angibt, ob das Gerät eingesteckt Zoll (boolesch)
Anwendungen sollten in der Regel verwenden document.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- iOS
- Android
- BlackBerry WebWorks (OS 5.0 und höher)
- Tizen
Kleines Beispiel
window.addEventListener("batterylow", onBatteryLow, false);
function onBatteryLow(info) {
// Handle the battery low event
alert("Battery Level Low " + info.level + "%");
}
Vollständiges Beispiel
<!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
Das Ereignis wird ausgelöst, wenn eine Änderung in den Batteriestatus vorliegt.
window.addEventListener("batterystatus", yourCallbackFunction, false);
Informationen
Dieses Ereignis wird ausgelöst, wenn der Prozentsatz der Akkuladung um mindestens 1 Prozent ändert, oder wenn das Gerät eingesteckt oder "Unplugged".
Der Batterie-Status-Handler wird ein Objekt übergeben, das zwei Eigenschaften enthält:
Ebene: der Prozentsatz der Batterieladung (0-100). (Anzahl)
IsPlugged: ein boolescher Wert, der angibt, ob das Gerät eingesteckt Zoll (boolesch)
Anwendungen sollten in der Regel verwenden window.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- iOS
- Android
- BlackBerry WebWorks (OS 5.0 und höher)
- Windows Phone 7 und 8
- Tizen
Windows Phone 7 und 8 Macken
Windows Phone 7 bietet keine systemeigenen APIs um zu bestimmen, Batterie-Niveau, so dass die level -Eigenschaft ist nicht verfügbar. Der isPlugged -Parameter wird unterstützt.
Kleines Beispiel
window.addEventListener("batterystatus", onBatteryStatus, false);
function onBatteryStatus(info) {
// Handle the online event
console.log("Level: " + info.level + " isPlugged: " + info.isPlugged);
}
Vollständiges Beispiel
<!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
Das Ereignis wird ausgelöst, wenn der Benutzer die Menü-Taste drückt.
document.addEventListener("menubutton", yourCallbackFunction, false);
Informationen
Anwenden eines Event-handlers überschreibt das Standardverhalten der Menü-Taste.
Anwendungen sollten in der Regel verwenden document.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- Android
- BlackBerry WebWorks (OS 5.0 und höher)
Kleines Beispiel
document.addEventListener("menubutton", onMenuKeyDown, false);
function onMenuKeyDown() {
// Handle the back button
}
Vollständiges Beispiel
<!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
Das Ereignis wird ausgelöst, wenn der Benutzer die Schaltfläche Suchen auf Android drückt.
document.addEventListener("searchbutton", yourCallbackFunction, false);
Informationen
Wenn Sie das Standardverhalten für die Schaltfläche von Suche auf Android überschreiben möchten können Sie einen Ereignis-Listener für das Ereignis 'Searchbutton' registrieren.
Anwendungen sollten in der Regel verwenden document.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- Android
Kleines Beispiel
document.addEventListener("searchbutton", onSearchKeyDown, false);
function onSearchKeyDown() {
// Handle the search button
}
Vollständiges Beispiel
<!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
Das Ereignis wird ausgelöst, wenn der Benutzer die Startschaltfläche drückt.
document.addEventListener("startcallbutton", yourCallbackFunction, false);
Informationen
Wenn Sie das Start-Aufruf Standardverhalten überschreiben möchten registrieren Sie einen Ereignis-Listener für das startcallbutton Ereignis.
Anwendungen sollten in der Regel verwenden document.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- BlackBerry WebWorks (OS 5.0 und höher)
Kleines Beispiel
document.addEventListener("startcallbutton", onStartCallKeyDown, false);
function onStartCallKeyDown() {
// Handle the start call button
}
Vollständiges Beispiel
<!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
Dieses Ereignis wird ausgelöst, wenn der Benutzer die End-Call-Taste drückt.
document.addEventListener("endcallbutton", yourCallbackFunction, false);
Informationen
Das Ereignis überschreibt das Standardverhalten des End-Aufruf.
Anwendungen sollten in der Regel verwenden document.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- BlackBerry WebWorks (OS 5.0 und höher)
Kleines Beispiel
document.addEventListener("endcallbutton", onEndCallKeyDown, false);
function onEndCallKeyDown() {
// Handle the end call button
}
Vollständiges Beispiel
<!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
Das Ereignis wird ausgelöst, wenn der Benutzer die Lautstärke-Taste drückt.
document.addEventListener("volumedownbutton", yourCallbackFunction, false);
Informationen
Wenn Sie die Standard-Lautstärke reduzieren Verhalten überschreiben müssen erfassen Sie einen Ereignis-Listener für das volumedownbutton Ereignis.
Anwendungen sollten in der Regel verwenden document.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- BlackBerry WebWorks (OS 5.0 und höher)
Kleines Beispiel
document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);
function onVolumeDownKeyDown() {
// Handle the volume down button
}
Vollständiges Beispiel
<!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
Das Ereignis wird ausgelöst, wenn der Benutzer die Lauter Taste drückt.
document.addEventListener("volumeupbutton", yourCallbackFunction, false);
Informationen
Wenn Sie die Standard-Lautstärke erhöhen Verhalten überschreiben müssen registrieren Sie einen Ereignis-Listener für das volumeupbutton Ereignis.
Anwendungen sollten in der Regel verwenden document.addEventListener einmal einen Ereignis-Listener hinzufügen das deviceready -Ereignis ausgelöst.
Unterstützte Plattformen
- BlackBerry WebWorks (OS 5.0 und höher)
Kleines Beispiel
document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);
function onVolumeUpKeyDown() {
// Handle the volume up button
}
Vollständiges Beispiel
<!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>