Thu, 04 Jun 2015 14:50:33 +0200
Genesis of lecture sources for Droidcon Berlin 2015 in Postbahnhof.
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
10 http://www.apache.org/licenses/LICENSE-2.0
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 -->
20 # org.apache.cordova.dialogs
22 Questo plugin consente di accedere ad alcuni elementi di interfaccia utente nativa del dialogo.
24 ## Installazione
26 cordova plugin add org.apache.cordova.dialogs
29 ## Metodi
31 * `navigator.notification.alert`
32 * `navigator.notification.confirm`
33 * `navigator.notification.prompt`
34 * `navigator.notification.beep`
36 ## navigator.notification.alert
38 Mostra una finestra di avviso o la finestra di dialogo personalizzata. La maggior parte delle implementazioni di Cordova una dialogo nativa per questa caratteristica, ma alcune piattaforme utilizzano il browser `alert` funzione, che è in genere meno personalizzabile.
40 navigator.notification.alert(message, alertCallback, [title], [buttonName])
43 * **messaggio**: messaggio finestra di dialogo. *(String)*
45 * **alertCallback**: Callback da richiamare quando viene chiusa la finestra di avviso. *(Funzione)*
47 * **titolo**: titolo di dialogo. *(String)* (Opzionale, default è`Alert`)
49 * **buttonName**: nome del pulsante. *(String)* (Opzionale, default è`OK`)
51 ### Esempio
53 function alertDismissed() {
54 // do something
55 }
57 navigator.notification.alert(
58 'You are the winner!', // message
59 alertDismissed, // callback
60 'Game Over', // title
61 'Done' // buttonName
62 );
65 ### Piattaforme supportate
67 * Amazon fuoco OS
68 * Android
69 * BlackBerry 10
70 * Firefox OS
71 * iOS
72 * Tizen
73 * Windows Phone 7 e 8
74 * Windows 8
76 ### Windows Phone 7 e 8 stranezze
78 * Non non c'è nessun avviso del browser integrato, ma è possibile associare uno come segue per chiamare `alert()` in ambito globale:
80 window.alert = navigator.notification.alert;
83 * Entrambi `alert` e `confirm` sono non di blocco chiamate, risultati di cui sono disponibili solo in modo asincrono.
85 ### Firefox OS Stranezze:
87 Entrambi nativi di blocco `window.alert()` e non bloccante `navigator.notification.alert()` sono disponibili.
89 ## navigator.notification.confirm
91 Visualizza una finestra di dialogo conferma personalizzabile.
93 navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
96 * **messaggio**: messaggio finestra di dialogo. *(String)*
98 * **confirmCallback**: Callback da richiamare con l'indice del pulsante premuto (1, 2 o 3) o quando la finestra di dialogo viene chiusa senza una pressione del pulsante (0). *(Funzione)*
100 * **titolo**: titolo di dialogo. *(String)* (Opzionale, default è`Confirm`)
102 * **buttonLabels**: matrice di stringhe che specificano le etichette dei pulsanti. *(Matrice)* (Opzionale, default è [ `OK,Cancel` ])
104 ### confirmCallback
106 Il `confirmCallback` viene eseguito quando l'utente preme uno dei pulsanti nella finestra di dialogo conferma.
108 Il callback accetta l'argomento `buttonIndex` *(numero)*, che è l'indice del pulsante premuto. Nota che l'indice utilizza l'indicizzazione base uno, quindi il valore è `1` , `2` , `3` , ecc.
110 ### Esempio
112 function onConfirm(buttonIndex) {
113 alert('You selected button ' + buttonIndex);
114 }
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 );
124 ### Piattaforme supportate
126 * Amazon fuoco OS
127 * Android
128 * BlackBerry 10
129 * Firefox OS
130 * iOS
131 * Tizen
132 * Windows Phone 7 e 8
133 * Windows 8
135 ### Windows Phone 7 e 8 stranezze
137 * Non non c'è nessuna funzione browser incorporato per `window.confirm` , ma è possibile associare assegnando:
139 window.confirm = navigator.notification.confirm;
142 * Chiama al `alert` e `confirm` sono non bloccante, quindi il risultato è disponibile solo in modo asincrono.
144 ### Firefox OS Stranezze:
146 Entrambi nativi di blocco `window.confirm()` e non bloccante `navigator.notification.confirm()` sono disponibili.
148 ## navigator.notification.prompt
150 Visualizza una finestra di dialogo nativa che è più personalizzabile del browser `prompt` funzione.
152 navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
155 * **messaggio**: messaggio finestra di dialogo. *(String)*
157 * **promptCallback**: Callback da richiamare con l'indice del pulsante premuto (1, 2 o 3) o quando la finestra di dialogo viene chiusa senza una pressione del pulsante (0). *(Funzione)*
159 * **titolo**: dialogo titolo *(String)* (opzionale, default è`Prompt`)
161 * **buttonLabels**: matrice di stringhe specificando il pulsante etichette *(Array)* (opzionale, default è`["OK","Cancel"]`)
163 * **defaultText**: valore di input predefinito textbox ( `String` ) (opzionale, Default: stringa vuota)
165 ### promptCallback
167 Il `promptCallback` viene eseguito quando l'utente preme uno dei pulsanti nella finestra di dialogo richiesta. Il `results` oggetto passato al metodo di callback contiene le seguenti proprietà:
169 * **buttonIndex**: l'indice del pulsante premuto. *(Numero)* Nota che l'indice utilizza l'indicizzazione base uno, quindi il valore è `1` , `2` , `3` , ecc.
171 * **INPUT1**: il testo immesso nella finestra di dialogo richiesta. *(String)*
173 ### Esempio
175 function onPrompt(results) {
176 alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
177 }
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 );
188 ### Piattaforme supportate
190 * Amazon fuoco OS
191 * Android
192 * Firefox OS
193 * iOS
194 * Windows Phone 7 e 8
196 ### Stranezze Android
198 * Android supporta un massimo di tre pulsanti e ignora di più di quello.
200 * Su Android 3.0 e versioni successive, i pulsanti vengono visualizzati in ordine inverso per dispositivi che utilizzano il tema Holo.
202 ### Firefox OS Stranezze:
204 Entrambi nativi di blocco `window.prompt()` e non bloccante `navigator.notification.prompt()` sono disponibili.
206 ## navigator.notification.beep
208 Il dispositivo riproduce un bip sonoro.
210 navigator.notification.beep(times);
213 * **volte**: il numero di volte per ripetere il segnale acustico. *(Numero)*
215 ### Esempio
217 // Beep twice!
218 navigator.notification.beep(2);
221 ### Piattaforme supportate
223 * Amazon fuoco OS
224 * Android
225 * BlackBerry 10
226 * iOS
227 * Tizen
228 * Windows Phone 7 e 8
229 * Windows 8
231 ### Amazon fuoco OS stranezze
233 * Amazon fuoco OS riproduce il **Suono di notifica** specificato sotto il pannello **Impostazioni/Display e il suono** predefinito.
235 ### Stranezze Android
237 * Android giochi default **Notification ringtone** specificato sotto il pannello **impostazioni/audio e Display** .
239 ### Windows Phone 7 e 8 stranezze
241 * Si basa su un file generico bip dalla distribuzione di Cordova.
243 ### Tizen stranezze
245 * Tizen implementa bip di riproduzione di un file audio tramite i media API.
247 * Il file beep deve essere breve, deve essere situato un `sounds` sottodirectory della directory radice dell'applicazione e deve essere denominato`beep.wav`.