1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
|
<!---
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`.
|
