droidcon / file revision

 <!---

     Licensed to the Apache Software Foundation (ASF) under one

     or more contributor license agreements.  See the NOTICE file

     distributed with this work for additional information

     regarding copyright ownership.  The ASF licenses this file

     to you under the Apache License, Version 2.0 (the

     "License"); you may not use this file except in compliance

     with the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,

     software distributed under the License is distributed on an

     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY

     KIND, either express or implied.  See the License for the

     specific language governing permissions and limitations

     under the License.

 -->

 # org.apache.cordova.dialogs

 Este plugin proporciona acceso a algunos elementos de la interfaz nativa de diálogo.

 ## Instalación

     cordova plugin add org.apache.cordova.dialogs

 ## Métodos

 *   `navigator.notification.alert`

 *   `navigator.notification.confirm`

 *   `navigator.notification.prompt`

 *   `navigator.notification.beep`

 ## navigator.notification.alert

 Muestra un cuadro de alerta o diálogo personalizado. La mayoría de las implementaciones de Cordova utilizan un cuadro de diálogo nativa para esta característica, pero algunas plataformas utilizan el navegador `alert` la función, que es típicamente menos personalizable.

     navigator.notification.alert(message, alertCallback, [title], [buttonName])

 *   **message**: mensaje de diálogo. *(String)*

 *   **alertCallback**: Callback para invocar al diálogo de alerta es desestimada. *(Función)*

 *   **title**: título de diálogo. *(String)* (Opcional, el valor predeterminado de `Alert`)

 *   **buttonName**: nombre del botón. *(String)* (Opcional, por defecto `Aceptar`)

 ### Ejemplo

     function alertDismissed() {

         // do something

     }

     navigator.notification.alert(

         'You are the winner!',  // message

         alertDismissed,         // callback

         'Game Over',            // title

         'Done'                  // buttonName

     );

 ### Plataformas soportadas

 *   Amazon fire OS

 *   Android

 *   BlackBerry 10

 *   Firefox OS

 *   iOS

 *   Tizen

 *   Windows Phone 7 y 8

 *   Windows 8

 ### Windows Phone 7 y 8 rarezas

 *   No hay ninguna alerta del navegador integrado, pero puede enlazar uno proceda a llamar `alert()` en el ámbito global:

         window.alert = navigator.notification.alert;

 *   `alert` y `confirm` son non-blocking llamadas, cuyos resultados sólo están disponibles de forma asincrónica.

 ### Firefox OS rarezas:

 Dos nativos de bloqueo `window.alert()` y no-bloqueo `navigator.notification.alert()` están disponibles.

 ## navigator.notification.confirm

 Muestra un cuadro de diálogo de confirmación personalizables.

     navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])

 *   **message**: mensaje de diálogo. *(String)*

 *   **confirmCallback**: Callback para invocar con índice de botón pulsado (1, 2 o 3) o cuando el diálogo es despedido sin la presión del botón (0). *(Función)*

 *   **title**: título de diálogo. *(String)* (Opcional, por defecto a `confirmar`)

 *   **buttonLabels**: matriz de cadenas especificando las etiquetas de botón. *(Matriz)* (Opcional, por defecto [`OK, cancelar`])

 ### confirmCallback

 El `confirmCallback` se ejecuta cuando el usuario presiona uno de los botones en el cuadro de diálogo de confirmación.

 La devolución de llamada toma el argumento `buttonIndex` *(número)*, que es el índice del botón presionado. Tenga en cuenta que el índice utiliza uno basado en la indexación, así que el valor es `1`, `2`, `3`, etc..

 ### Ejemplo

     function onConfirm(buttonIndex) {

         alert('You selected button ' + buttonIndex);

     }

     navigator.notification.confirm(

         'You are the winner!', // message

          onConfirm,            // callback to invoke with index of button pressed

         'Game Over',           // title

         ['Restart','Exit']     // buttonLabels

     );

 ### Plataformas soportadas

 *   Amazon fire OS

 *   Android

 *   BlackBerry 10

 *   Firefox OS

 *   iOS

 *   Tizen

 *   Windows Phone 7 y 8

 *   Windows 8

 ### Windows Phone 7 y 8 rarezas

 *   No hay ninguna función de navegador incorporado para `window.confirm`, pero lo puede enlazar mediante la asignación:

         window.confirm = navigator.notification.confirm;

 *   Llamadas de `alert` y `confirm` son non-blocking, así que el resultado sólo está disponible de forma asincrónica.

 ### Firefox OS rarezas:

 Dos nativos de bloqueo `window.confirm()` y no-bloqueo `navigator.notification.confirm()` están disponibles.

 ## navigator.notification.prompt

 Muestra un cuadro de diálogo nativa que es más personalizable que del navegador `prompt` función.

     navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])

 *   **message**: mensaje de diálogo. *(String)*

 *   **promptCallback**: Callback para invocar con índice del botón pulsado (1, 2 ó 3) o cuando el cuadro de diálogo es despedido sin la presión del botón (0). *(Función)*

 *   **title**: título *(String)* (opcional, por defecto `puntual` de diálogo)

 *   **buttonLabels**: matriz de cadenas especificando el botón etiquetas *(Array)* (opcional, por defecto `["OK", "Cancelar"]`)

 *   **defaultText**: valor de la entrada predeterminada textbox ( `String` ) (opcional, por defecto: cadena vacía)

 ### promptCallback

 El `promptCallback` se ejecuta cuando el usuario presiona uno de los botones en el cuadro de diálogo pronto. El objeto de `resultados` pasado a la devolución de llamada contiene las siguientes propiedades:

 *   **buttonIndex**: el índice del botón presionado. *(Número)* Tenga en cuenta que el índice utiliza uno basado en la indexación, así que el valor es `1`, `2`, `3`, etc..

 *   **input1**: el texto introducido en el cuadro de diálogo pronto. *(String)*

 ### Ejemplo

     function onPrompt(results) {

         alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);

     }

     navigator.notification.prompt(

         'Please enter your name',  // message

         onPrompt,                  // callback to invoke

         'Registration',            // title

         ['Ok','Exit'],             // buttonLabels

         'Jane Doe'                 // defaultText

     );

 ### Plataformas soportadas

 *   Amazon fire OS

 *   Android

 *   Firefox OS

 *   iOS

 *   Windows Phone 7 y 8

 ### Rarezas Android

 *   Android soporta un máximo de tres botones e ignora nada más.

 *   En Android 3.0 y posteriores, los botones se muestran en orden inverso para dispositivos que utilizan el tema de Holo.

 ### Firefox OS rarezas:

 Dos nativos de bloqueo `window.prompt()` y no-bloqueo `navigator.notification.prompt()` están disponibles.

 ## navigator.notification.beep

 El dispositivo reproduce un sonido sonido.

     navigator.notification.beep(times);

 *   **times**: el número de veces a repetir la señal. *(Número)*

 ### Ejemplo

     / / Pitido dos veces! 

     navigator.notification.beep(2);

 ### Plataformas soportadas

 *   Amazon fire OS

 *   Android

 *   BlackBerry 10

 *   iOS

 *   Tizen

 *   Windows Phone 7 y 8

 *   Windows 8

 ### Amazon fuego OS rarezas

 *   Amazon fuego OS reproduce el **Sonido de notificación** especificados en el panel de **configuración/pantalla y sonido** por defecto.

 ### Rarezas Android

 *   Android juega el **tono de notificación** especificados en el panel **ajustes de sonido y pantalla** por defecto.

 ### Windows Phone 7 y 8 rarezas

 *   Se basa en un archivo de sonido genérico de la distribución de Cordova.

 ### Rarezas Tizen

 *   Tizen implementa pitidos por reproducir un archivo de audio a través de los medios de comunicación API.

 *   El archivo de sonido debe ser corto, debe estar ubicado en un `sounds` subdirectorio del directorio raíz de la aplicación y deben ser nombrados`beep.wav`.