PhoneGap/Cordova: gli eventi



Quando si realizzano applicazioni ibride , bisogna prestare molta attenzione agli "eventi" del'app, che sono una parte fondamentale di PhoneGap.

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!");
}
});

Published: January 03 2014

  • category: