# 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"!
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://ajgallego.gitbook.io/phonegap/capitulo_eventos.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.