248 lines
8.5 KiB
Markdown
248 lines
8.5 KiB
Markdown
|
<!---
|
||
|
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.
|
||
|
-->
|
||
|
|
||
|
# cordova-plugin-dialogs
|
||
|
|
||
|
Este plugin permite acceder a algunos elementos de interfaz de usuario nativa diálogo vía global `navigator.notification` objeto.
|
||
|
|
||
|
Aunque el objeto está unido al ámbito global `navigator` , no estará disponible hasta después de la `deviceready` evento.
|
||
|
|
||
|
document.addEventListener ("deviceready", onDeviceReady, false);
|
||
|
function onDeviceReady() {console.log(navigator.notification)};
|
||
|
|
||
|
|
||
|
## Instalación
|
||
|
|
||
|
Cordova plugin agregar cordova-plugin-dialogs
|
||
|
|
||
|
|
||
|
## Métodos
|
||
|
|
||
|
* `navigator.notification.alert`
|
||
|
* `navigator.notification.confirm`
|
||
|
* `navigator.notification.prompt`
|
||
|
* `navigator.notification.beep`
|
||
|
|
||
|
## navigator.notification.alert
|
||
|
|
||
|
Muestra un cuadro de alerta o cuadro de 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 (mensaje, 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() {/ / hacer algo} navigator.notification.alert ('Tú eres el ganador!', / / mensaje alertDismissed, / / callback 'Game Over', / / título 'hecho' / / buttonName);
|
||
|
|
||
|
|
||
|
### Plataformas soportadas
|
||
|
|
||
|
* Amazon fire OS
|
||
|
* Android
|
||
|
* BlackBerry 10
|
||
|
* Firefox OS
|
||
|
* iOS
|
||
|
* Tizen
|
||
|
* Windows Phone 7 y 8
|
||
|
* Windows 8
|
||
|
* Windows
|
||
|
|
||
|
### 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.
|
||
|
|
||
|
### BlackBerry 10 rarezas
|
||
|
|
||
|
`navigator.notification.alert('text', callback, 'title', 'text')`parámetro de devolución de llamada se pasa el número 1.
|
||
|
|
||
|
## navigator.notification.confirm
|
||
|
|
||
|
Muestra un cuadro de diálogo de confirmación personalizables.
|
||
|
|
||
|
Navigator.Notification.CONFIRM (mensaje, 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. Observe que el índice utiliza indexación basada en uno, entonces el valor es `1` , `2` , `3` , etc..
|
||
|
|
||
|
### Ejemplo
|
||
|
|
||
|
function onConfirm(buttonIndex) {alert ('Tu botón seleccionado' + buttonIndex);}
|
||
|
|
||
|
Navigator.Notification.CONFIRM ('Tú eres el ganador!', / / mensaje onConfirm, / callback para invocar con índice del botón pulsado 'Game Over', / / / título ['reiniciar', 'Exit'] / / buttonLabels);
|
||
|
|
||
|
|
||
|
### Plataformas soportadas
|
||
|
|
||
|
* Amazon fire OS
|
||
|
* Android
|
||
|
* BlackBerry 10
|
||
|
* Firefox OS
|
||
|
* iOS
|
||
|
* Tizen
|
||
|
* Windows Phone 7 y 8
|
||
|
* Windows 8
|
||
|
* Windows
|
||
|
|
||
|
### 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.
|
||
|
|
||
|
### Windows rarezas
|
||
|
|
||
|
* Sobre Windows8/8.1 no es posible agregar más de tres botones a instancia de MessageDialog.
|
||
|
|
||
|
* En Windows Phone 8.1 no es posible Mostrar cuadro de diálogo con más de dos botones.
|
||
|
|
||
|
### 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 (mensaje, promptCallback, [title], [buttonLabels], [defaultText])
|
||
|
|
||
|
|
||
|
* **mensaje**: 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)*
|
||
|
|
||
|
* **título**: título *(String)* (opcional, por defecto de diálogo`Prompt`)
|
||
|
|
||
|
* **buttonLabels**: matriz de cadenas especificando botón etiquetas *(Array)* (opcional, por defecto`["OK","Cancel"]`)
|
||
|
|
||
|
* **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 del cuadro de diálogo pronto. El `results` objeto que se pasa a la devolución de llamada contiene las siguientes propiedades:
|
||
|
|
||
|
* **buttonIndex**: el índice del botón presionado. *(Número)* Observe que el índice utiliza indexación basada en uno, entonces el valor es `1` , `2` , `3` , etc..
|
||
|
|
||
|
* **INPUT1**: el texto introducido en el cuadro de diálogo pronto. *(String)*
|
||
|
|
||
|
### Ejemplo
|
||
|
|
||
|
function onPrompt(results) {alert ("seleccionaron botón número" + results.buttonIndex + "y entró en" + results.input1);}
|
||
|
|
||
|
Navigator.Notification.prompt ('Por favor introduce tu nombre', / / mensaje onPrompt, / / callback para invocar 'Registro', / / título ['Ok', 'Exit'], / / buttonLabels 'Jane Doe' / / defaultText);
|
||
|
|
||
|
|
||
|
### Plataformas soportadas
|
||
|
|
||
|
* Amazon fuego OS
|
||
|
* Android
|
||
|
* Firefox OS
|
||
|
* iOS
|
||
|
* Windows Phone 7 y 8
|
||
|
* Windows 8
|
||
|
* Windows
|
||
|
|
||
|
### Rarezas Android
|
||
|
|
||
|
* Android soporta un máximo de tres botones e ignora nada más.
|
||
|
|
||
|
* En Android 3.0 y posteriores, los botones aparecen en orden inverso para dispositivos que utilizan el tema Holo.
|
||
|
|
||
|
### Windows rarezas
|
||
|
|
||
|
* En Windows pronto diálogo está basado en html debido a falta de tal api nativa.
|
||
|
|
||
|
### Firefox OS rarezas:
|
||
|
|
||
|
Dos nativos de bloqueo `window.prompt()` y no-bloqueo `navigator.notification.prompt()` están disponibles.
|
||
|
|
||
|
## navigator.notification.beep
|
||
|
|
||
|
El aparato reproduce un sonido sonido.
|
||
|
|
||
|
Navigator.Notification.Beep(Times);
|
||
|
|
||
|
|
||
|
* **tiempos**: el número de veces a repetir la señal. *(Número)*
|
||
|
|
||
|
### Ejemplo
|
||
|
|
||
|
Dos pitidos.
|
||
|
Navigator.Notification.Beep(2);
|
||
|
|
||
|
|
||
|
### Plataformas soportadas
|
||
|
|
||
|
* Amazon fuego 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
|
||
|
|
||
|
* Androide reproduce el **tono de notificación** especificados en el panel **ajustes de sonido y visualización** por defecto.
|
||
|
|
||
|
### Windows Phone 7 y 8 rarezas
|
||
|
|
||
|
* Se basa en un archivo de sonido genérico de la distribución de Córdoba.
|
||
|
|
||
|
### 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`.
|