PhoneGap/Cordova: gli eventi
Questi eventi vengono emessi sul documento e forniscono degli hooks indispensabili al corretto comportamento della vostra applicazione.
Vediamone alcuni.
deviceready
Questo evento viene emesso quando Cordova è stato completamente caricato, e le API del dispositivo sono pronte all'uso.
Questo è il momento giusto per avviare l'applicazione, in questo modo:
document.addEventListener("deviceready", function() {
// Codice di avvio dell'applicazione
});
pause
L'evento viene scatenato quando l'applicazione viene posta in background. Può essere utile per interrompere alcune operazioni (come l'esecuzione di un audio) quando si passa da un'app a un'altra:
document.addEventListener("pause", function() {
navigator.notification.alert("App in pausa!");
});
resume
Come è facilmente prevedibile, l'evento resume viene scatenato quando l'App ritorna in primo piano:document.addEventListener("resume", function() {
navigator.notification.alert("App in primo piano!");
});batterystatus & batterycritical
Questi ultimi eventi risultano molto utili: senza andare a scomodare le Battery API (ancora non supportate da tutte le piattaforme) possiamo utilizzare questi due eventi per intercettare rispettivamente un cambiamento dello stato della batteria e il raggiungimento della soglia critica della carica:
document.addEventListener("batterystatus", function(info) {
if(!info.isPlugged) {
navigator.notification.alert("Il livello della batteria e' " + info.level + ".");
}
});
document.addEventListener("batterycritical", function(info) {
if(!info.isPlugged) {
navigator.notification.alert("La batteria e' quasi scarica! (" + info.level + ")! Collega il caricabatterie!");
}
});