Touchgui/plugins/org.apache.cordova.dialogs/doc/de/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.

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

mercurial