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 | Dieses Plugin ermöglicht den Zugriff auf einige native Dialog-UI-Elemente. |
michael@0 | 23 | |
michael@0 | 24 | ## Installation |
michael@0 | 25 | |
michael@0 | 26 | cordova plugin add org.apache.cordova.dialogs |
michael@0 | 27 | |
michael@0 | 28 | |
michael@0 | 29 | ## Methoden |
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 | Zeigt eine benutzerdefinierte Warnung oder Dialogfeld Feld. Die meisten Implementierungen von Cordova ein native Dialogfeld für dieses Feature verwenden, aber einige Plattformen des Browsers `alert` Funktion, die in der Regel weniger anpassbar ist. |
michael@0 | 39 | |
michael@0 | 40 | Navigator.Notification.Alert (Message, AlertCallback, [Titel], [ButtonName]) |
michael@0 | 41 | |
michael@0 | 42 | |
michael@0 | 43 | * **Nachricht**: Dialogfeld Nachricht. *(String)* |
michael@0 | 44 | |
michael@0 | 45 | * **AlertCallback**: Callback aufgerufen wird, wenn Warnungs-Dialogfeld geschlossen wird. *(Funktion)* |
michael@0 | 46 | |
michael@0 | 47 | * **Titel**: Dialog "Titel". *(String)* (Optional, Standard ist`Alert`) |
michael@0 | 48 | |
michael@0 | 49 | * **ButtonName**: Name der Schaltfläche. *(String)* (Optional, Standard ist`OK`) |
michael@0 | 50 | |
michael@0 | 51 | ### Beispiel |
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 | ### Unterstützte Plattformen |
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 und 8 |
michael@0 | 74 | * Windows 8 |
michael@0 | 75 | |
michael@0 | 76 | ### Windows Phone 7 und 8 Eigenarten |
michael@0 | 77 | |
michael@0 | 78 | * Es gibt keine eingebaute Datenbanksuchroutine-Warnung, aber Sie können binden, wie folgt zu nennen `alert()` im globalen Gültigkeitsbereich: |
michael@0 | 79 | |
michael@0 | 80 | window.alert = navigator.notification.alert; |
michael@0 | 81 | |
michael@0 | 82 | |
michael@0 | 83 | * Beide `alert` und `confirm` sind nicht blockierende Aufrufe, die Ergebnisse davon nur asynchron sind. |
michael@0 | 84 | |
michael@0 | 85 | ### Firefox OS Macken: |
michael@0 | 86 | |
michael@0 | 87 | Beide Native blockierenden `window.alert()` und nicht-blockierende `navigator.notification.alert()` stehen zur Verfügung. |
michael@0 | 88 | |
michael@0 | 89 | ## navigator.notification.confirm |
michael@0 | 90 | |
michael@0 | 91 | Zeigt das Dialogfeld anpassbare Bestätigung. |
michael@0 | 92 | |
michael@0 | 93 | navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) |
michael@0 | 94 | |
michael@0 | 95 | |
michael@0 | 96 | * **Nachricht**: Dialogfeld Nachricht. *(String)* |
michael@0 | 97 | |
michael@0 | 98 | * **ConfirmCallback**: Callback aufgerufen wird, mit Index gedrückt (1, 2 oder 3) oder wenn das Dialogfeld geschlossen wird, ohne einen Tastendruck (0). *(Funktion)* |
michael@0 | 99 | |
michael@0 | 100 | * **Titel**: Dialog "Titel". *(String)* (Optional, Standard ist`Confirm`) |
michael@0 | 101 | |
michael@0 | 102 | * **ButtonLabels**: Array von Zeichenfolgen, die Schaltflächenbezeichnungen angeben. *(Array)* (Optional, Standard ist [ `OK,Cancel` ]) |
michael@0 | 103 | |
michael@0 | 104 | ### confirmCallback |
michael@0 | 105 | |
michael@0 | 106 | Die `confirmCallback` wird ausgeführt, wenn der Benutzer eine der Schaltflächen im Dialogfeld zur Bestätigung drückt. |
michael@0 | 107 | |
michael@0 | 108 | Der Rückruf dauert das Argument `buttonIndex` *(Anzahl)*, die der Index der Schaltfläche gedrückt ist. Beachten Sie, dass der Index 1-basierte Indizierung, verwendet, sodass der Wert ist `1` , `2` , `3` , etc.. |
michael@0 | 109 | |
michael@0 | 110 | ### Beispiel |
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 | ### Unterstützte Plattformen |
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 und 8 |
michael@0 | 133 | * Windows 8 |
michael@0 | 134 | |
michael@0 | 135 | ### Windows Phone 7 und 8 Eigenarten |
michael@0 | 136 | |
michael@0 | 137 | * Es gibt keine integrierte Browser-Funktion für `window.confirm` , aber Sie können es binden, indem Sie zuweisen: |
michael@0 | 138 | |
michael@0 | 139 | window.confirm = navigator.notification.confirm; |
michael@0 | 140 | |
michael@0 | 141 | |
michael@0 | 142 | * Aufrufe von `alert` und `confirm` sind nicht blockierend, so dass das Ergebnis nur asynchron zur Verfügung steht. |
michael@0 | 143 | |
michael@0 | 144 | ### Firefox OS Macken: |
michael@0 | 145 | |
michael@0 | 146 | Beide Native blockierenden `window.confirm()` und nicht-blockierende `navigator.notification.confirm()` stehen zur Verfügung. |
michael@0 | 147 | |
michael@0 | 148 | ## navigator.notification.prompt |
michael@0 | 149 | |
michael@0 | 150 | Zeigt eine native Dialogfeld, das mehr als des Browsers anpassbar ist `prompt` Funktion. |
michael@0 | 151 | |
michael@0 | 152 | navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) |
michael@0 | 153 | |
michael@0 | 154 | |
michael@0 | 155 | * **Nachricht**: Dialogfeld Nachricht. *(String)* |
michael@0 | 156 | |
michael@0 | 157 | * **PromptCallback**: Callback aufgerufen wird, mit Index gedrückt (1, 2 oder 3) oder wenn das Dialogfeld geschlossen wird, ohne einen Tastendruck (0). *(Funktion)* |
michael@0 | 158 | |
michael@0 | 159 | * **Titel**: Dialog Title *(String)* (Optional, Standard ist`Prompt`) |
michael@0 | 160 | |
michael@0 | 161 | * **ButtonLabels**: Array von Zeichenfolgen angeben Schaltfläche Etiketten *(Array)* (Optional, Standard ist`["OK","Cancel"]`) |
michael@0 | 162 | |
michael@0 | 163 | * **DefaultText**: Standard-Textbox Eingabewert ( `String` ) (Optional, Standard: leere Zeichenfolge) |
michael@0 | 164 | |
michael@0 | 165 | ### promptCallback |
michael@0 | 166 | |
michael@0 | 167 | Die `promptCallback` wird ausgeführt, wenn der Benutzer eine der Schaltflächen im Eingabedialogfeld drückt. Die `results` an den Rückruf übergebene Objekt enthält die folgenden Eigenschaften: |
michael@0 | 168 | |
michael@0 | 169 | * **ButtonIndex**: der Index der Schaltfläche gedrückt. *(Anzahl)* Beachten Sie, dass der Index 1-basierte Indizierung, verwendet, sodass der Wert ist `1` , `2` , `3` , etc.. |
michael@0 | 170 | |
michael@0 | 171 | * **Eingang1**: in Eingabedialogfeld eingegebenen Text. *(String)* |
michael@0 | 172 | |
michael@0 | 173 | ### Beispiel |
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 | ### Unterstützte Plattformen |
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 und 8 |
michael@0 | 195 | |
michael@0 | 196 | ### Android Eigenarten |
michael@0 | 197 | |
michael@0 | 198 | * Android unterstützt maximal drei Schaltflächen und mehr als das ignoriert. |
michael@0 | 199 | |
michael@0 | 200 | * Auf Android 3.0 und höher, werden die Schaltflächen in umgekehrter Reihenfolge für Geräte angezeigt, die das Holo-Design verwenden. |
michael@0 | 201 | |
michael@0 | 202 | ### Firefox OS Macken: |
michael@0 | 203 | |
michael@0 | 204 | Beide Native blockierenden `window.prompt()` und nicht-blockierende `navigator.notification.prompt()` stehen zur Verfügung. |
michael@0 | 205 | |
michael@0 | 206 | ## navigator.notification.beep |
michael@0 | 207 | |
michael@0 | 208 | Das Gerät spielt einen Signalton sound. |
michael@0 | 209 | |
michael@0 | 210 | navigator.notification.beep(times); |
michael@0 | 211 | |
michael@0 | 212 | |
michael@0 | 213 | * **Zeiten**: die Anzahl der Wiederholungen des Signaltons. *(Anzahl)* |
michael@0 | 214 | |
michael@0 | 215 | ### Beispiel |
michael@0 | 216 | |
michael@0 | 217 | // Beep twice! |
michael@0 | 218 | navigator.notification.beep(2); |
michael@0 | 219 | |
michael@0 | 220 | |
michael@0 | 221 | ### Unterstützte Plattformen |
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 und 8 |
michael@0 | 229 | * Windows 8 |
michael@0 | 230 | |
michael@0 | 231 | ### Amazon Fire OS Macken |
michael@0 | 232 | |
michael@0 | 233 | * Amazon Fire OS spielt die Standardeinstellung **Akustische Benachrichtigung** unter **Einstellungen/Display & Sound** Bereich angegeben. |
michael@0 | 234 | |
michael@0 | 235 | ### Android Eigenarten |
michael@0 | 236 | |
michael@0 | 237 | * Android spielt die Standardeinstellung **Benachrichtigung Klingelton** unter **Einstellungen/Sound & Display** -Panel angegeben. |
michael@0 | 238 | |
michael@0 | 239 | ### Windows Phone 7 und 8 Eigenarten |
michael@0 | 240 | |
michael@0 | 241 | * Stützt sich auf eine generische Piepton-Datei aus der Cordova-Distribution. |
michael@0 | 242 | |
michael@0 | 243 | ### Tizen Macken |
michael@0 | 244 | |
michael@0 | 245 | * Tizen implementiert Signaltöne durch Abspielen einer Audiodatei über die Medien API. |
michael@0 | 246 | |
michael@0 | 247 | * Die Beep-Datei muss kurz sein, befinden muss einem `sounds` Unterverzeichnis des Stammverzeichnisses der Anwendung, und muss den Namen`beep.wav`. |