michael@0: <!---
michael@0:     Licensed to the Apache Software Foundation (ASF) under one
michael@0:     or more contributor license agreements.  See the NOTICE file
michael@0:     distributed with this work for additional information
michael@0:     regarding copyright ownership.  The ASF licenses this file
michael@0:     to you under the Apache License, Version 2.0 (the
michael@0:     "License"); you may not use this file except in compliance
michael@0:     with the License.  You may obtain a copy of the License at
michael@0: 
michael@0:       http://www.apache.org/licenses/LICENSE-2.0
michael@0: 
michael@0:     Unless required by applicable law or agreed to in writing,
michael@0:     software distributed under the License is distributed on an
michael@0:     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0:     KIND, either express or implied.  See the License for the
michael@0:     specific language governing permissions and limitations
michael@0:     under the License.
michael@0: -->
michael@0: 
michael@0: # org.apache.cordova.dialogs
michael@0: 
michael@0: Questo plugin consente di accedere ad alcuni elementi di interfaccia utente nativa del dialogo.
michael@0: 
michael@0: ## Installazione
michael@0: 
michael@0:     cordova plugin add org.apache.cordova.dialogs
michael@0:     
michael@0: 
michael@0: ## Metodi
michael@0: 
michael@0: *   `navigator.notification.alert`
michael@0: *   `navigator.notification.confirm`
michael@0: *   `navigator.notification.prompt`
michael@0: *   `navigator.notification.beep`
michael@0: 
michael@0: ## navigator.notification.alert
michael@0: 
michael@0: 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.
michael@0: 
michael@0:     navigator.notification.alert(message, alertCallback, [title], [buttonName])
michael@0:     
michael@0: 
michael@0: *   **messaggio**: messaggio finestra di dialogo. *(String)*
michael@0: 
michael@0: *   **alertCallback**: Callback da richiamare quando viene chiusa la finestra di avviso. *(Funzione)*
michael@0: 
michael@0: *   **titolo**: titolo di dialogo. *(String)* (Opzionale, default è`Alert`)
michael@0: 
michael@0: *   **buttonName**: nome del pulsante. *(String)* (Opzionale, default è`OK`)
michael@0: 
michael@0: ### Esempio
michael@0: 
michael@0:     function alertDismissed() {
michael@0:         // do something
michael@0:     }
michael@0:     
michael@0:     navigator.notification.alert(
michael@0:         'You are the winner!',  // message
michael@0:         alertDismissed,         // callback
michael@0:         'Game Over',            // title
michael@0:         'Done'                  // buttonName
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Piattaforme supportate
michael@0: 
michael@0: *   Amazon fuoco OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 e 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Windows Phone 7 e 8 stranezze
michael@0: 
michael@0: *   Non non c'è nessun avviso del browser integrato, ma è possibile associare uno come segue per chiamare `alert()` in ambito globale:
michael@0:     
michael@0:         window.alert = navigator.notification.alert;
michael@0:         
michael@0: 
michael@0: *   Entrambi `alert` e `confirm` sono non di blocco chiamate, risultati di cui sono disponibili solo in modo asincrono.
michael@0: 
michael@0: ### Firefox OS Stranezze:
michael@0: 
michael@0: Entrambi nativi di blocco `window.alert()` e non bloccante `navigator.notification.alert()` sono disponibili.
michael@0: 
michael@0: ## navigator.notification.confirm
michael@0: 
michael@0: Visualizza una finestra di dialogo conferma personalizzabile.
michael@0: 
michael@0:     navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
michael@0:     
michael@0: 
michael@0: *   **messaggio**: messaggio finestra di dialogo. *(String)*
michael@0: 
michael@0: *   **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)*
michael@0: 
michael@0: *   **titolo**: titolo di dialogo. *(String)* (Opzionale, default è`Confirm`)
michael@0: 
michael@0: *   **buttonLabels**: matrice di stringhe che specificano le etichette dei pulsanti. *(Matrice)* (Opzionale, default è [ `OK,Cancel` ])
michael@0: 
michael@0: ### confirmCallback
michael@0: 
michael@0: Il `confirmCallback` viene eseguito quando l'utente preme uno dei pulsanti nella finestra di dialogo conferma.
michael@0: 
michael@0: 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.
michael@0: 
michael@0: ### Esempio
michael@0: 
michael@0:     function onConfirm(buttonIndex) {
michael@0:         alert('You selected button ' + buttonIndex);
michael@0:     }
michael@0:     
michael@0:     navigator.notification.confirm(
michael@0:         'You are the winner!', // message
michael@0:          onConfirm,            // callback to invoke with index of button pressed
michael@0:         'Game Over',           // title
michael@0:         ['Restart','Exit']     // buttonLabels
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Piattaforme supportate
michael@0: 
michael@0: *   Amazon fuoco OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 e 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Windows Phone 7 e 8 stranezze
michael@0: 
michael@0: *   Non non c'è nessuna funzione browser incorporato per `window.confirm` , ma è possibile associare assegnando:
michael@0:     
michael@0:         window.confirm = navigator.notification.confirm;
michael@0:         
michael@0: 
michael@0: *   Chiama al `alert` e `confirm` sono non bloccante, quindi il risultato è disponibile solo in modo asincrono.
michael@0: 
michael@0: ### Firefox OS Stranezze:
michael@0: 
michael@0: Entrambi nativi di blocco `window.confirm()` e non bloccante `navigator.notification.confirm()` sono disponibili.
michael@0: 
michael@0: ## navigator.notification.prompt
michael@0: 
michael@0: Visualizza una finestra di dialogo nativa che è più personalizzabile del browser `prompt` funzione.
michael@0: 
michael@0:     navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
michael@0:     
michael@0: 
michael@0: *   **messaggio**: messaggio finestra di dialogo. *(String)*
michael@0: 
michael@0: *   **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)*
michael@0: 
michael@0: *   **titolo**: dialogo titolo *(String)* (opzionale, default è`Prompt`)
michael@0: 
michael@0: *   **buttonLabels**: matrice di stringhe specificando il pulsante etichette *(Array)* (opzionale, default è`["OK","Cancel"]`)
michael@0: 
michael@0: *   **defaultText**: valore di input predefinito textbox ( `String` ) (opzionale, Default: stringa vuota)
michael@0: 
michael@0: ### promptCallback
michael@0: 
michael@0: 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à:
michael@0: 
michael@0: *   **buttonIndex**: l'indice del pulsante premuto. *(Numero)* Nota che l'indice utilizza l'indicizzazione base uno, quindi il valore è `1` , `2` , `3` , ecc.
michael@0: 
michael@0: *   **INPUT1**: il testo immesso nella finestra di dialogo richiesta. *(String)*
michael@0: 
michael@0: ### Esempio
michael@0: 
michael@0:     function onPrompt(results) {
michael@0:         alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
michael@0:     }
michael@0:     
michael@0:     navigator.notification.prompt(
michael@0:         'Please enter your name',  // message
michael@0:         onPrompt,                  // callback to invoke
michael@0:         'Registration',            // title
michael@0:         ['Ok','Exit'],             // buttonLabels
michael@0:         'Jane Doe'                 // defaultText
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Piattaforme supportate
michael@0: 
michael@0: *   Amazon fuoco OS
michael@0: *   Android
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Windows Phone 7 e 8
michael@0: 
michael@0: ### Stranezze Android
michael@0: 
michael@0: *   Android supporta un massimo di tre pulsanti e ignora di più di quello.
michael@0: 
michael@0: *   Su Android 3.0 e versioni successive, i pulsanti vengono visualizzati in ordine inverso per dispositivi che utilizzano il tema Holo.
michael@0: 
michael@0: ### Firefox OS Stranezze:
michael@0: 
michael@0: Entrambi nativi di blocco `window.prompt()` e non bloccante `navigator.notification.prompt()` sono disponibili.
michael@0: 
michael@0: ## navigator.notification.beep
michael@0: 
michael@0: Il dispositivo riproduce un bip sonoro.
michael@0: 
michael@0:     navigator.notification.beep(times);
michael@0:     
michael@0: 
michael@0: *   **volte**: il numero di volte per ripetere il segnale acustico. *(Numero)*
michael@0: 
michael@0: ### Esempio
michael@0: 
michael@0:     // Beep twice!
michael@0:     navigator.notification.beep(2);
michael@0:     
michael@0: 
michael@0: ### Piattaforme supportate
michael@0: 
michael@0: *   Amazon fuoco OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 e 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Amazon fuoco OS stranezze
michael@0: 
michael@0: *   Amazon fuoco OS riproduce il **Suono di notifica** specificato sotto il pannello **Impostazioni/Display e il suono** predefinito.
michael@0: 
michael@0: ### Stranezze Android
michael@0: 
michael@0: *   Android giochi default **Notification ringtone** specificato sotto il pannello **impostazioni/audio e Display** .
michael@0: 
michael@0: ### Windows Phone 7 e 8 stranezze
michael@0: 
michael@0: *   Si basa su un file generico bip dalla distribuzione di Cordova.
michael@0: 
michael@0: ### Tizen stranezze
michael@0: 
michael@0: *   Tizen implementa bip di riproduzione di un file audio tramite i media API.
michael@0: 
michael@0: *   Il file beep deve essere breve, deve essere situato un `sounds` sottodirectory della directory radice dell'applicazione e deve essere denominato`beep.wav`.