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 Ten plugin umożliwia dostęp do niektórych rodzimych okna dialogowego elementy interfejsu użytkownika.
24 ## Instalacja
26 cordova plugin add org.apache.cordova.dialogs
29 ## Metody
31 * `navigator.notification.alert`
32 * `navigator.notification.confirm`
33 * `navigator.notification.prompt`
34 * `navigator.notification.beep`
36 ## navigator.notification.alert
38 Pokazuje niestandardowe wpisu lub okno dialogowe. Większość implementacji Cordova używać rodzimych okno dialogowe dla tej funkcji, ale niektóre platformy używać przeglądarki `alert` funkcja, który jest zazwyczaj mniej konfigurowalny.
40 navigator.notification.alert(message, alertCallback, [title], [buttonName])
43 * **wiadomość**: komunikat okna dialogowego. *(String)*
45 * **alertCallback**: wywołanie zwrotne do wywołania, gdy okno dialogowe alert jest oddalona. *(Funkcja)*
47 * **tytuł**: okno tytuł. *(String)* (Opcjonalna, domyślnie`Alert`)
49 * **buttonName**: Nazwa przycisku. *(String)* (Opcjonalna, domyślnie`OK`)
51 ### Przykład
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 ### Obsługiwane platformy
67 * Amazon Fire OS
68 * Android
69 * BlackBerry 10
70 * Firefox OS
71 * iOS
72 * Tizen
73 * Windows Phone 7 i 8
74 * Windows 8
76 ### Windows Phone 7 i 8 dziwactwa
78 * Istnieje wpis nie wbudowana przeglądarka, ale można powiązać w następujący sposób na wywołanie `alert()` w globalnym zasięgu:
80 window.alert = navigator.notification.alert;
83 * Zarówno `alert` i `confirm` są bez blokowania połączeń, których wyniki są tylko dostępne asynchronicznie.
85 ### Firefox OS dziwactwa:
87 Blokuje zarówno rodzimych `window.alert()` i bez blokowania `navigator.notification.alert()` są dostępne.
89 ## navigator.notification.confirm
91 Wyświetla okno dialogowe potwierdzenia konfigurowalny.
93 navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
96 * **wiadomość**: komunikat okna dialogowego. *(String)*
98 * **confirmCallback**: wywołanie zwrotne do wywołania z indeksu z przycisku (1, 2 lub 3), lub gdy okno jest zwolniony bez naciśnij przycisk (0). *(Funkcja)*
100 * **tytuł**: okno tytuł. *(String)* (Opcjonalna, domyślnie`Confirm`)
102 * **buttonLabels**: tablica ciągów, określając etykiety przycisków. *(Tablica)* (Opcjonalna, domyślnie [ `OK,Cancel` ])
104 ### confirmCallback
106 `confirmCallback`Wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym potwierdzenia.
108 Wywołania zwrotnego przyjmuje argument `buttonIndex` *(numer)*, który jest indeksem wciśnięty przycisk. Uwaga, że indeks używa, na podstawie jednego indeksowania, więc wartość jest `1` , `2` , `3` , itp.
110 ### Przykład
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 ### Obsługiwane platformy
126 * Amazon Fire OS
127 * Android
128 * BlackBerry 10
129 * Firefox OS
130 * iOS
131 * Tizen
132 * Windows Phone 7 i 8
133 * Windows 8
135 ### Windows Phone 7 i 8 dziwactwa
137 * Istnieje funkcja wbudowana przeglądarka nie `window.confirm` , ale można go powiązać przypisując:
139 window.confirm = navigator.notification.confirm;
142 * Wzywa do `alert` i `confirm` są bez blokowania, więc wynik jest tylko dostępnych asynchronicznie.
144 ### Firefox OS dziwactwa:
146 Blokuje zarówno rodzimych `window.confirm()` i bez blokowania `navigator.notification.confirm()` są dostępne.
148 ## navigator.notification.prompt
150 Wyświetla okno dialogowe macierzystego, który bardziej niż przeglądarki `prompt` funkcja.
152 navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
155 * **wiadomość**: komunikat okna dialogowego. *(String)*
157 * **promptCallback**: wywołanie zwrotne do wywołania z indeksu z przycisku (1, 2 lub 3), lub gdy okno jest zwolniony bez naciśnij przycisk (0). *(Funkcja)*
159 * **tytuł**: okno tytuł *(String)* (opcjonalna, domyślnie`Prompt`)
161 * **buttonLabels**: tablica ciągów, określając przycisk etykiety *(tablica)* (opcjonalna, domyślnie`["OK","Cancel"]`)
163 * **defaultText**: wartość wejściowa tekstowym domyślnego ( `String` ) (opcjonalna, domyślnie: pusty ciąg)
165 ### promptCallback
167 `promptCallback`Wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym polecenia. `results`Obiekt przekazywany do wywołania zwrotnego zawiera następujące właściwości:
169 * **buttonIndex**: indeks wciśnięty przycisk. *(Liczba)* Uwaga, że indeks używa, na podstawie jednego indeksowania, więc wartość jest `1` , `2` , `3` , itp.
171 * **input1**: Tekst wprowadzony w oknie polecenia. *(String)*
173 ### Przykład
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 ### Obsługiwane platformy
190 * Amazon Fire OS
191 * Android
192 * Firefox OS
193 * iOS
194 * Windows Phone 7 i 8
196 ### Dziwactwa Androida
198 * Android obsługuje maksymalnie trzy przyciski i więcej niż to ignoruje.
200 * Android 3.0 i nowszych przyciski są wyświetlane w kolejności odwrotnej do urządzenia, które używają tematu Holo.
202 ### Firefox OS dziwactwa:
204 Blokuje zarówno rodzimych `window.prompt()` i bez blokowania `navigator.notification.prompt()` są dostępne.
206 ## navigator.notification.beep
208 Urządzenie odtwarza sygnał ciągły dźwięk.
210 navigator.notification.beep(times);
213 * **razy**: liczba powtórzeń po sygnale. *(Liczba)*
215 ### Przykład
217 // Beep twice!
218 navigator.notification.beep(2);
221 ### Obsługiwane platformy
223 * Amazon Fire OS
224 * Android
225 * BlackBerry 10
226 * iOS
227 * Tizen
228 * Windows Phone 7 i 8
229 * Windows 8
231 ### Amazon ogień OS dziwactwa
233 * Amazon ogień OS gra domyślny **Dźwięk powiadomienia** określone w panelu **ekranu/ustawienia i dźwięk** .
235 ### Dziwactwa Androida
237 * Android gra domyślnie **dzwonek powiadomienia** określone w panelu **ustawień/dźwięk i wyświetlacz** .
239 ### Windows Phone 7 i 8 dziwactwa
241 * Opiera się na pliku rodzajowego sygnał z rozkładu Cordova.
243 ### Dziwactwa Tizen
245 * Tizen implementuje dźwięków przez odtwarzania pliku audio za pośrednictwem mediów API.
247 * Plik dźwiękowy muszą być krótkie, musi znajdować się w `sounds` podkatalogu katalogu głównego aplikacji i musi być nazwany`beep.wav`.