> For the complete documentation index, see [llms.txt](https://ajgallego.gitbook.io/phonegap/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajgallego.gitbook.io/phonegap/capitulo_eventos.md).
# Eventos
La librería de PhoneGap incluye una serie de eventos JavaScript a los cuales podemos escuchar para realizar determinadas acciones cuando se produzcan. Estos eventos son:
* *deviceready*
* *pause*
* *resume*
* *backbutton*
* *menubutton*
* *searchbutton*
* *startcallbutton*
* *endcallbutton*
* *volumedownbutton*
* *volumeupbutton*
Si instalamos el *plugin* para el control de la batería (*org.apache.cordova.battery-status*) se añadirán los siguientes eventos (ver sección de *plugins*):
* *batterycritical*
* *batterylow*
* *batterystatus*
Si instalamos el *plugin* para obtener información de la red (*org.apache.cordova.network-information*) se añadirán los siguientes eventos (ver sección de *plugins*):
* *online*
* *offline*
En general para suscribirnos a un evento utilizaremos el siguiente código:
```
document.addEventListener("nombre-evento", funcionCallback, false);
```
Donde:
* *nombre-evento*: es el evento al que queremos escuchar.
* *funcionCallback*: es la función que se llamará cuando el evento se produzca.
* *false*: afecta al orden en el que se lanzará el evento, al inicio (cuando se producte) o al final (cuando ya ha terminado).
A continuación se describen los principales eventos de PhoneGap y se incluyen ejemplos de uso.
## *deviceready*
Este evento se ejecuta cuando la librería de PhoneGap se ha cargado completamente. Su uso es esencial para cualquier aplicación y lo tendremos que utilizar de forma inicial para asegurarnos de que la API se ha cargado completamente.
A continuación se incluye un ejemplo de uso:
```markup
Ejemplo
```
## *pause*
Este evento se produce cuando la aplicación pasa a segundo plano. A continuación se incluye un ejemplo completo de uso:
```markup
Pause Example
```
> En todos los eventos tendremos que esperar a que la API de PhoneGap termine de cargar.
## *resume*
Este evento se produce cuando la aplicación estaba en segundo plano y se vuelve a mostrar en primer plano. A continuación se incluye un ejemplo completo de uso:
```markup
Resume Example
```
## *backbutton*
Este evento se produce cuando el usuario pulsa el botón atrás. A continuación se incluye un ejemplo completo de uso:
```markup
Back Button Example
```
**Salir de la aplicación**
Por defecto, al pulsar el botón *back* no se cerrará la aplicación. Si queremos que se cierre tendremos que hacer:
```javascript
document.addEventListener("backbutton", onBackKeyDown, false);
function onBackKeyDown() {
navigator.app.exitApp()
}
```
Hemos de tener cuidado con esta funcionalidad porque cerrará la aplicación siempre que se pulse dicha tecla. Si nuestra aplicación tiene varias páginas y queremos que se use el botón *back* para volver a la página anterior y además que en la primera página cierre la aplicación tendremos que distinguir entre las páginas y solo cerrar en la primera.
## *menubutton*
Este evento se produce cuando el usuario pulsa el botón menú. Para su utilización, igual que en el resto de casos, simplemente tendremos que hacer (ejemplo abreviado):
```javascript
document.addEventListener("menubutton", onMenuKeyDown, false);
function onMenuKeyDown() {
// Se ha producido el evento "menubutton"!
}
```
## *volumedownbutton*
Este evento se produce cuando el usuario pulsa el botón para bajar el volumen. A continuación se incluye un ejemplo abreviado de uso:
```
document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);
function onVolumeDownKeyDown() {
// Se ha producido el evento "volumedownbutton"!
}
```
## *volumeupbutton*
Este evento se lanza cuando se pulsa el botón para subir el volumen. Igual que en el resto de casos, para su utilización tenemos que hacer:
```
document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);
function onVolumeUpKeyDown() {
// Se ha producido el evento "volumeupbutton"!
}
```