Touchgui/plugins/org.apache.cordova.dialogs/doc/es/index.md

changeset 0
e8ccd40d0ef6
equal deleted inserted replaced
-1:000000000000 0:1525e50cb346
1 <!---
2 Licensed to the Apache Software Foundation (ASF) under one
3 or more contributor license agreements. See the NOTICE file
4 distributed with this work for additional information
5 regarding copyright ownership. The ASF licenses this file
6 to you under the Apache License, Version 2.0 (the
7 "License"); you may not use this file except in compliance
8 with the License. You may obtain a copy of the License at
9
10 http://www.apache.org/licenses/LICENSE-2.0
11
12 Unless required by applicable law or agreed to in writing,
13 software distributed under the License is distributed on an
14 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 KIND, either express or implied. See the License for the
16 specific language governing permissions and limitations
17 under the License.
18 -->
19
20 # org.apache.cordova.dialogs
21
22 Este plugin proporciona acceso a algunos elementos de la interfaz nativa de diálogo.
23
24 ## Instalación
25
26 cordova plugin add org.apache.cordova.dialogs
27
28
29 ## Métodos
30
31 * `navigator.notification.alert`
32 * `navigator.notification.confirm`
33 * `navigator.notification.prompt`
34 * `navigator.notification.beep`
35
36 ## navigator.notification.alert
37
38 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.
39
40 navigator.notification.alert(message, alertCallback, [title], [buttonName])
41
42
43 * **message**: mensaje de diálogo. *(String)*
44
45 * **alertCallback**: Callback para invocar al diálogo de alerta es desestimada. *(Función)*
46
47 * **title**: título de diálogo. *(String)* (Opcional, el valor predeterminado de `Alert`)
48
49 * **buttonName**: nombre del botón. *(String)* (Opcional, por defecto `Aceptar`)
50
51 ### Ejemplo
52
53 function alertDismissed() {
54 // do something
55 }
56
57 navigator.notification.alert(
58 'You are the winner!', // message
59 alertDismissed, // callback
60 'Game Over', // title
61 'Done' // buttonName
62 );
63
64
65 ### Plataformas soportadas
66
67 * Amazon fire OS
68 * Android
69 * BlackBerry 10
70 * Firefox OS
71 * iOS
72 * Tizen
73 * Windows Phone 7 y 8
74 * Windows 8
75
76 ### Windows Phone 7 y 8 rarezas
77
78 * No hay ninguna alerta del navegador integrado, pero puede enlazar uno proceda a llamar `alert()` en el ámbito global:
79
80 window.alert = navigator.notification.alert;
81
82
83 * `alert` y `confirm` son non-blocking llamadas, cuyos resultados sólo están disponibles de forma asincrónica.
84
85 ### Firefox OS rarezas:
86
87 Dos nativos de bloqueo `window.alert()` y no-bloqueo `navigator.notification.alert()` están disponibles.
88
89 ## navigator.notification.confirm
90
91 Muestra un cuadro de diálogo de confirmación personalizables.
92
93 navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
94
95
96 * **message**: mensaje de diálogo. *(String)*
97
98 * **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)*
99
100 * **title**: título de diálogo. *(String)* (Opcional, por defecto a `confirmar`)
101
102 * **buttonLabels**: matriz de cadenas especificando las etiquetas de botón. *(Matriz)* (Opcional, por defecto [`OK, cancelar`])
103
104 ### confirmCallback
105
106 El `confirmCallback` se ejecuta cuando el usuario presiona uno de los botones en el cuadro de diálogo de confirmación.
107
108 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..
109
110 ### Ejemplo
111
112 function onConfirm(buttonIndex) {
113 alert('You selected button ' + buttonIndex);
114 }
115
116 navigator.notification.confirm(
117 'You are the winner!', // message
118 onConfirm, // callback to invoke with index of button pressed
119 'Game Over', // title
120 ['Restart','Exit'] // buttonLabels
121 );
122
123
124 ### Plataformas soportadas
125
126 * Amazon fire OS
127 * Android
128 * BlackBerry 10
129 * Firefox OS
130 * iOS
131 * Tizen
132 * Windows Phone 7 y 8
133 * Windows 8
134
135 ### Windows Phone 7 y 8 rarezas
136
137 * No hay ninguna función de navegador incorporado para `window.confirm`, pero lo puede enlazar mediante la asignación:
138
139 window.confirm = navigator.notification.confirm;
140
141
142 * Llamadas de `alert` y `confirm` son non-blocking, así que el resultado sólo está disponible de forma asincrónica.
143
144 ### Firefox OS rarezas:
145
146 Dos nativos de bloqueo `window.confirm()` y no-bloqueo `navigator.notification.confirm()` están disponibles.
147
148 ## navigator.notification.prompt
149
150 Muestra un cuadro de diálogo nativa que es más personalizable que del navegador `prompt` función.
151
152 navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
153
154
155 * **message**: mensaje de diálogo. *(String)*
156
157 * **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)*
158
159 * **title**: título *(String)* (opcional, por defecto `puntual` de diálogo)
160
161 * **buttonLabels**: matriz de cadenas especificando el botón etiquetas *(Array)* (opcional, por defecto `["OK", "Cancelar"]`)
162
163 * **defaultText**: valor de la entrada predeterminada textbox ( `String` ) (opcional, por defecto: cadena vacía)
164
165 ### promptCallback
166
167 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:
168
169 * **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..
170
171 * **input1**: el texto introducido en el cuadro de diálogo pronto. *(String)*
172
173 ### Ejemplo
174
175 function onPrompt(results) {
176 alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
177 }
178
179 navigator.notification.prompt(
180 'Please enter your name', // message
181 onPrompt, // callback to invoke
182 'Registration', // title
183 ['Ok','Exit'], // buttonLabels
184 'Jane Doe' // defaultText
185 );
186
187
188 ### Plataformas soportadas
189
190 * Amazon fire OS
191 * Android
192 * Firefox OS
193 * iOS
194 * Windows Phone 7 y 8
195
196 ### Rarezas Android
197
198 * Android soporta un máximo de tres botones e ignora nada más.
199
200 * En Android 3.0 y posteriores, los botones se muestran en orden inverso para dispositivos que utilizan el tema de Holo.
201
202 ### Firefox OS rarezas:
203
204 Dos nativos de bloqueo `window.prompt()` y no-bloqueo `navigator.notification.prompt()` están disponibles.
205
206 ## navigator.notification.beep
207
208 El dispositivo reproduce un sonido sonido.
209
210 navigator.notification.beep(times);
211
212
213 * **times**: el número de veces a repetir la señal. *(Número)*
214
215 ### Ejemplo
216
217 / / Pitido dos veces!
218 navigator.notification.beep(2);
219
220
221 ### Plataformas soportadas
222
223 * Amazon fire OS
224 * Android
225 * BlackBerry 10
226 * iOS
227 * Tizen
228 * Windows Phone 7 y 8
229 * Windows 8
230
231 ### Amazon fuego OS rarezas
232
233 * Amazon fuego OS reproduce el **Sonido de notificación** especificados en el panel de **configuración/pantalla y sonido** por defecto.
234
235 ### Rarezas Android
236
237 * Android juega el **tono de notificación** especificados en el panel **ajustes de sonido y pantalla** por defecto.
238
239 ### Windows Phone 7 y 8 rarezas
240
241 * Se basa en un archivo de sonido genérico de la distribución de Cordova.
242
243 ### Rarezas Tizen
244
245 * Tizen implementa pitidos por reproducir un archivo de audio a través de los medios de comunicación API.
246
247 * 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`.

mercurial