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

Thu, 04 Jun 2015 14:50:33 +0200

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Thu, 04 Jun 2015 14:50:33 +0200
changeset 0
e8ccd40d0ef6
permissions
-rw-r--r--

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`.

mercurial