Thu, 04 Jun 2015 14:50:33 +0200
Genesis of lecture sources for Droidcon Berlin 2015 in Postbahnhof.
michael@0 | 1 | <!--- |
michael@0 | 2 | Licensed to the Apache Software Foundation (ASF) under one |
michael@0 | 3 | or more contributor license agreements. See the NOTICE file |
michael@0 | 4 | distributed with this work for additional information |
michael@0 | 5 | regarding copyright ownership. The ASF licenses this file |
michael@0 | 6 | to you under the Apache License, Version 2.0 (the |
michael@0 | 7 | "License"); you may not use this file except in compliance |
michael@0 | 8 | with the License. You may obtain a copy of the License at |
michael@0 | 9 | |
michael@0 | 10 | http://www.apache.org/licenses/LICENSE-2.0 |
michael@0 | 11 | |
michael@0 | 12 | Unless required by applicable law or agreed to in writing, |
michael@0 | 13 | software distributed under the License is distributed on an |
michael@0 | 14 | "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
michael@0 | 15 | KIND, either express or implied. See the License for the |
michael@0 | 16 | specific language governing permissions and limitations |
michael@0 | 17 | under the License. |
michael@0 | 18 | --> |
michael@0 | 19 | |
michael@0 | 20 | # org.apache.cordova.dialogs |
michael@0 | 21 | |
michael@0 | 22 | Ten plugin umożliwia dostęp do niektórych rodzimych okna dialogowego elementy interfejsu użytkownika. |
michael@0 | 23 | |
michael@0 | 24 | ## Instalacja |
michael@0 | 25 | |
michael@0 | 26 | cordova plugin add org.apache.cordova.dialogs |
michael@0 | 27 | |
michael@0 | 28 | |
michael@0 | 29 | ## Metody |
michael@0 | 30 | |
michael@0 | 31 | * `navigator.notification.alert` |
michael@0 | 32 | * `navigator.notification.confirm` |
michael@0 | 33 | * `navigator.notification.prompt` |
michael@0 | 34 | * `navigator.notification.beep` |
michael@0 | 35 | |
michael@0 | 36 | ## navigator.notification.alert |
michael@0 | 37 | |
michael@0 | 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. |
michael@0 | 39 | |
michael@0 | 40 | navigator.notification.alert(message, alertCallback, [title], [buttonName]) |
michael@0 | 41 | |
michael@0 | 42 | |
michael@0 | 43 | * **wiadomość**: komunikat okna dialogowego. *(String)* |
michael@0 | 44 | |
michael@0 | 45 | * **alertCallback**: wywołanie zwrotne do wywołania, gdy okno dialogowe alert jest oddalona. *(Funkcja)* |
michael@0 | 46 | |
michael@0 | 47 | * **tytuł**: okno tytuł. *(String)* (Opcjonalna, domyślnie`Alert`) |
michael@0 | 48 | |
michael@0 | 49 | * **buttonName**: Nazwa przycisku. *(String)* (Opcjonalna, domyślnie`OK`) |
michael@0 | 50 | |
michael@0 | 51 | ### Przykład |
michael@0 | 52 | |
michael@0 | 53 | function alertDismissed() { |
michael@0 | 54 | // do something |
michael@0 | 55 | } |
michael@0 | 56 | |
michael@0 | 57 | navigator.notification.alert( |
michael@0 | 58 | 'You are the winner!', // message |
michael@0 | 59 | alertDismissed, // callback |
michael@0 | 60 | 'Game Over', // title |
michael@0 | 61 | 'Done' // buttonName |
michael@0 | 62 | ); |
michael@0 | 63 | |
michael@0 | 64 | |
michael@0 | 65 | ### Obsługiwane platformy |
michael@0 | 66 | |
michael@0 | 67 | * Amazon Fire OS |
michael@0 | 68 | * Android |
michael@0 | 69 | * BlackBerry 10 |
michael@0 | 70 | * Firefox OS |
michael@0 | 71 | * iOS |
michael@0 | 72 | * Tizen |
michael@0 | 73 | * Windows Phone 7 i 8 |
michael@0 | 74 | * Windows 8 |
michael@0 | 75 | |
michael@0 | 76 | ### Windows Phone 7 i 8 dziwactwa |
michael@0 | 77 | |
michael@0 | 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: |
michael@0 | 79 | |
michael@0 | 80 | window.alert = navigator.notification.alert; |
michael@0 | 81 | |
michael@0 | 82 | |
michael@0 | 83 | * Zarówno `alert` i `confirm` są bez blokowania połączeń, których wyniki są tylko dostępne asynchronicznie. |
michael@0 | 84 | |
michael@0 | 85 | ### Firefox OS dziwactwa: |
michael@0 | 86 | |
michael@0 | 87 | Blokuje zarówno rodzimych `window.alert()` i bez blokowania `navigator.notification.alert()` są dostępne. |
michael@0 | 88 | |
michael@0 | 89 | ## navigator.notification.confirm |
michael@0 | 90 | |
michael@0 | 91 | Wyświetla okno dialogowe potwierdzenia konfigurowalny. |
michael@0 | 92 | |
michael@0 | 93 | navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) |
michael@0 | 94 | |
michael@0 | 95 | |
michael@0 | 96 | * **wiadomość**: komunikat okna dialogowego. *(String)* |
michael@0 | 97 | |
michael@0 | 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)* |
michael@0 | 99 | |
michael@0 | 100 | * **tytuł**: okno tytuł. *(String)* (Opcjonalna, domyślnie`Confirm`) |
michael@0 | 101 | |
michael@0 | 102 | * **buttonLabels**: tablica ciągów, określając etykiety przycisków. *(Tablica)* (Opcjonalna, domyślnie [ `OK,Cancel` ]) |
michael@0 | 103 | |
michael@0 | 104 | ### confirmCallback |
michael@0 | 105 | |
michael@0 | 106 | `confirmCallback`Wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym potwierdzenia. |
michael@0 | 107 | |
michael@0 | 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. |
michael@0 | 109 | |
michael@0 | 110 | ### Przykład |
michael@0 | 111 | |
michael@0 | 112 | function onConfirm(buttonIndex) { |
michael@0 | 113 | alert('You selected button ' + buttonIndex); |
michael@0 | 114 | } |
michael@0 | 115 | |
michael@0 | 116 | navigator.notification.confirm( |
michael@0 | 117 | 'You are the winner!', // message |
michael@0 | 118 | onConfirm, // callback to invoke with index of button pressed |
michael@0 | 119 | 'Game Over', // title |
michael@0 | 120 | ['Restart','Exit'] // buttonLabels |
michael@0 | 121 | ); |
michael@0 | 122 | |
michael@0 | 123 | |
michael@0 | 124 | ### Obsługiwane platformy |
michael@0 | 125 | |
michael@0 | 126 | * Amazon Fire OS |
michael@0 | 127 | * Android |
michael@0 | 128 | * BlackBerry 10 |
michael@0 | 129 | * Firefox OS |
michael@0 | 130 | * iOS |
michael@0 | 131 | * Tizen |
michael@0 | 132 | * Windows Phone 7 i 8 |
michael@0 | 133 | * Windows 8 |
michael@0 | 134 | |
michael@0 | 135 | ### Windows Phone 7 i 8 dziwactwa |
michael@0 | 136 | |
michael@0 | 137 | * Istnieje funkcja wbudowana przeglądarka nie `window.confirm` , ale można go powiązać przypisując: |
michael@0 | 138 | |
michael@0 | 139 | window.confirm = navigator.notification.confirm; |
michael@0 | 140 | |
michael@0 | 141 | |
michael@0 | 142 | * Wzywa do `alert` i `confirm` są bez blokowania, więc wynik jest tylko dostępnych asynchronicznie. |
michael@0 | 143 | |
michael@0 | 144 | ### Firefox OS dziwactwa: |
michael@0 | 145 | |
michael@0 | 146 | Blokuje zarówno rodzimych `window.confirm()` i bez blokowania `navigator.notification.confirm()` są dostępne. |
michael@0 | 147 | |
michael@0 | 148 | ## navigator.notification.prompt |
michael@0 | 149 | |
michael@0 | 150 | Wyświetla okno dialogowe macierzystego, który bardziej niż przeglądarki `prompt` funkcja. |
michael@0 | 151 | |
michael@0 | 152 | navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) |
michael@0 | 153 | |
michael@0 | 154 | |
michael@0 | 155 | * **wiadomość**: komunikat okna dialogowego. *(String)* |
michael@0 | 156 | |
michael@0 | 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)* |
michael@0 | 158 | |
michael@0 | 159 | * **tytuł**: okno tytuł *(String)* (opcjonalna, domyślnie`Prompt`) |
michael@0 | 160 | |
michael@0 | 161 | * **buttonLabels**: tablica ciągów, określając przycisk etykiety *(tablica)* (opcjonalna, domyślnie`["OK","Cancel"]`) |
michael@0 | 162 | |
michael@0 | 163 | * **defaultText**: wartość wejściowa tekstowym domyślnego ( `String` ) (opcjonalna, domyślnie: pusty ciąg) |
michael@0 | 164 | |
michael@0 | 165 | ### promptCallback |
michael@0 | 166 | |
michael@0 | 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: |
michael@0 | 168 | |
michael@0 | 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. |
michael@0 | 170 | |
michael@0 | 171 | * **input1**: Tekst wprowadzony w oknie polecenia. *(String)* |
michael@0 | 172 | |
michael@0 | 173 | ### Przykład |
michael@0 | 174 | |
michael@0 | 175 | function onPrompt(results) { |
michael@0 | 176 | alert("You selected button number " + results.buttonIndex + " and entered " + results.input1); |
michael@0 | 177 | } |
michael@0 | 178 | |
michael@0 | 179 | navigator.notification.prompt( |
michael@0 | 180 | 'Please enter your name', // message |
michael@0 | 181 | onPrompt, // callback to invoke |
michael@0 | 182 | 'Registration', // title |
michael@0 | 183 | ['Ok','Exit'], // buttonLabels |
michael@0 | 184 | 'Jane Doe' // defaultText |
michael@0 | 185 | ); |
michael@0 | 186 | |
michael@0 | 187 | |
michael@0 | 188 | ### Obsługiwane platformy |
michael@0 | 189 | |
michael@0 | 190 | * Amazon Fire OS |
michael@0 | 191 | * Android |
michael@0 | 192 | * Firefox OS |
michael@0 | 193 | * iOS |
michael@0 | 194 | * Windows Phone 7 i 8 |
michael@0 | 195 | |
michael@0 | 196 | ### Dziwactwa Androida |
michael@0 | 197 | |
michael@0 | 198 | * Android obsługuje maksymalnie trzy przyciski i więcej niż to ignoruje. |
michael@0 | 199 | |
michael@0 | 200 | * Android 3.0 i nowszych przyciski są wyświetlane w kolejności odwrotnej do urządzenia, które używają tematu Holo. |
michael@0 | 201 | |
michael@0 | 202 | ### Firefox OS dziwactwa: |
michael@0 | 203 | |
michael@0 | 204 | Blokuje zarówno rodzimych `window.prompt()` i bez blokowania `navigator.notification.prompt()` są dostępne. |
michael@0 | 205 | |
michael@0 | 206 | ## navigator.notification.beep |
michael@0 | 207 | |
michael@0 | 208 | Urządzenie odtwarza sygnał ciągły dźwięk. |
michael@0 | 209 | |
michael@0 | 210 | navigator.notification.beep(times); |
michael@0 | 211 | |
michael@0 | 212 | |
michael@0 | 213 | * **razy**: liczba powtórzeń po sygnale. *(Liczba)* |
michael@0 | 214 | |
michael@0 | 215 | ### Przykład |
michael@0 | 216 | |
michael@0 | 217 | // Beep twice! |
michael@0 | 218 | navigator.notification.beep(2); |
michael@0 | 219 | |
michael@0 | 220 | |
michael@0 | 221 | ### Obsługiwane platformy |
michael@0 | 222 | |
michael@0 | 223 | * Amazon Fire OS |
michael@0 | 224 | * Android |
michael@0 | 225 | * BlackBerry 10 |
michael@0 | 226 | * iOS |
michael@0 | 227 | * Tizen |
michael@0 | 228 | * Windows Phone 7 i 8 |
michael@0 | 229 | * Windows 8 |
michael@0 | 230 | |
michael@0 | 231 | ### Amazon ogień OS dziwactwa |
michael@0 | 232 | |
michael@0 | 233 | * Amazon ogień OS gra domyślny **Dźwięk powiadomienia** określone w panelu **ekranu/ustawienia i dźwięk** . |
michael@0 | 234 | |
michael@0 | 235 | ### Dziwactwa Androida |
michael@0 | 236 | |
michael@0 | 237 | * Android gra domyślnie **dzwonek powiadomienia** określone w panelu **ustawień/dźwięk i wyświetlacz** . |
michael@0 | 238 | |
michael@0 | 239 | ### Windows Phone 7 i 8 dziwactwa |
michael@0 | 240 | |
michael@0 | 241 | * Opiera się na pliku rodzajowego sygnał z rozkładu Cordova. |
michael@0 | 242 | |
michael@0 | 243 | ### Dziwactwa Tizen |
michael@0 | 244 | |
michael@0 | 245 | * Tizen implementuje dźwięków przez odtwarzania pliku audio za pośrednictwem mediów API. |
michael@0 | 246 | |
michael@0 | 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`. |