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

changeset 0
e8ccd40d0ef6
equal deleted inserted replaced
-1:000000000000 0:1505cd1ec15b
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
9
10 http://www.apache.org/licenses/LICENSE-2.0
11
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 -->
19
20 # org.apache.cordova.dialogs
21
22 Ce plugin permet d'accéder à certains éléments d'interface utilisateur native de dialogue.
23
24 ## Installation
25
26 cordova plugin add org.apache.cordova.dialogs
27
28
29 ## Méthodes
30
31 * `navigator.notification.alert`
32 * `navigator.notification.confirm`
33 * `navigator.notification.prompt`
34 * `navigator.notification.beep`
35
36 ## navigator.notification.alert
37
38 Affiche une boîte de dialogue ou d'alerte personnalisé. La plupart des implémentations de Cordova utilisent une boîte de dialogue natives pour cette fonctionnalité, mais certaines plates-formes du navigateur `alert` fonction, qui est généralement moins personnalisable.
39
40 Navigator.notification.Alert (message, alertCallback, [titre], [buttonName])
41
42
43 * **message**: message de la boîte de dialogue. *(String)*
44
45 * **alertCallback**: callback à appeler lorsque la boîte de dialogue d'alerte est rejetée. *(Fonction)*
46
47 * **titre**: titre de la boîte de dialogue. *(String)* (Facultatif, par défaut`Alert`)
48
49 * **buttonName**: nom du bouton. *(String)* (Facultatif, par défaut`OK`)
50
51 ### Exemple
52
53 function alertDismissed() {
54 // do something
55 }
56
57 navigator.notification.alert(
58 'You are the winner!', // message
59 alertDismissed, // callback
60 'Game Over', // title
61 'Done' // buttonName
62 );
63
64
65 ### Plates-formes prises en charge
66
67 * Amazon Fire OS
68 * Android
69 * BlackBerry 10
70 * Firefox OS
71 * iOS
72 * Tizen
73 * Windows Phone 7 et 8
74 * Windows 8
75
76 ### Windows Phone 7 et 8 Quirks
77
78 * Il n'y a aucune boîte de dialogue d'alerte intégrée au navigateur, mais vous pouvez en lier une pour appeler `alert()` dans le scope global:
79
80 window.alert = navigator.notification.alert;
81
82
83 * Les deux appels `alert` et `confirm` sont non-blocants, leurs résultats ne sont disponibles que de façon asynchrone.
84
85 ### Firefox OS Quirks :
86
87 Les deux indigènes bloquant `window.alert()` et non-bloquante `navigator.notification.alert()` sont disponibles.
88
89 ## navigator.notification.confirm
90
91 Affiche une boîte de dialogue de confirmation personnalisable.
92
93 navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
94
95
96 * **message**: message de la boîte de dialogue. *(String)*
97
98 * **confirmCallback**: callback à appeler avec l'index du bouton pressé (1, 2 ou 3) ou lorsque la boîte de dialogue est fermée sans qu'un bouton ne soit pressé (0). *(Fonction)*
99
100 * **titre**: titre de dialogue. *(String)* (Facultatif, par défaut`Confirm`)
101
102 * **buttonLabels**: tableau de chaînes spécifiant les étiquettes des boutons. *(Array)* (Optionnel, par défaut, [ `OK,Cancel` ])
103
104 ### confirmCallback
105
106 Le `confirmCallback` s'exécute lorsque l'utilisateur appuie sur un bouton dans la boîte de dialogue de confirmation.
107
108 Le rappel prend l'argument `buttonIndex` *(nombre)*, qui est l'index du bouton activé. Notez que l'index utilise base d'indexation, la valeur est `1` , `2` , `3` , etc..
109
110 ### Exemple
111
112 function onConfirm(buttonIndex) {
113 alert('You selected button ' + buttonIndex);
114 }
115
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 );
122
123
124 ### Plates-formes prises en charge
125
126 * Amazon Fire OS
127 * Android
128 * BlackBerry 10
129 * Firefox OS
130 * iOS
131 * Paciarelli
132 * Windows Phone 7 et 8
133 * Windows 8
134
135 ### Windows Phone 7 et 8 Quirks
136
137 * Il n'y a aucune fonction intégrée au navigateur pour `window.confirm`, mais vous pouvez en lier une en affectant:
138
139 window.confirm = navigator.notification.confirm ;
140
141
142 * Les appels à `alert` et `confirm` sont non-bloquants, donc le résultat est seulement disponible de façon asynchrone.
143
144 ### Firefox OS Quirks :
145
146 Les deux indigènes bloquant `window.confirm()` et non-bloquante `navigator.notification.confirm()` sont disponibles.
147
148 ## navigator.notification.prompt
149
150 Affiche une boîte de dialogue natif qui est plus personnalisable que le navigateur `prompt` fonction.
151
152 navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
153
154
155 * **message**: message de la boîte de dialogue. *(String)*
156
157 * **promptCallback**: rappel d'invoquer avec l'index du bouton pressé (1, 2 ou 3) ou lorsque la boîte de dialogue est fermée sans une presse de bouton (0). *(Fonction)*
158
159 * **titre**: titre de la boîte de dialogue. *(String)* (Facultatif, par défaut`Alert`)
160
161 * **buttonLabels**: tableau de chaînes spécifiant les étiquettes de boutons *(Array)* (facultatif, par défaut, les étiquettes `["OK","Cancel"]`)
162
163 * **defaultText**: texte par défaut de la zone de texte ( `String` ) (en option, par défaut : chaîne vide)
164
165 ### promptCallback
166
167 Le `promptCallback` s'exécute lorsque l'utilisateur appuie sur un bouton dans la boîte de dialogue d'invite. Le `results` objet passé au rappel contient les propriétés suivantes :
168
169 * **buttonIndex**: l'index du bouton activé. *(Nombre)* Notez que l'index utilise une indexation de base 1, donc la valeur est `1` , `2` , `3` , etc.
170
171 * **entrée 1**: le texte entré dans la boîte de dialogue d'invite. *(String)*
172
173 ### Exemple
174
175 function onPrompt(results) {
176 alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
177 }
178
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 );
186
187
188 ### Plates-formes prises en charge
189
190 * Amazon Fire OS
191 * Android
192 * Firefox OS
193 * iOS
194 * Windows Phone 7 et 8
195
196 ### Quirks Android
197
198 * Android prend en charge un maximum de trois boutons et ignore plus que cela.
199
200 * Sur Android 3.0 et versions ultérieures, les boutons sont affichés dans l'ordre inverse pour les appareils qui utilisent le thème Holo.
201
202 ### Firefox OS Quirks :
203
204 Les deux indigènes bloquant `window.prompt()` et non-bloquante `navigator.notification.prompt()` sont disponibles.
205
206 ## navigator.notification.beep
207
208 Le dispositif joue un bip sonore.
209
210 navigator.notification.beep(times);
211
212
213 * **temps**: le nombre de fois répéter le bip. *(Nombre)*
214
215 ### Exemple
216
217 // Beep twice!
218 navigator.notification.beep(2);
219
220
221 ### Plates-formes prises en charge
222
223 * Amazon Fire OS
224 * Android
225 * BlackBerry 10
226 * iOS
227 * Paciarelli
228 * Windows Phone 7 et 8
229 * Windows 8
230
231 ### Amazon Fire OS Quirks
232
233 * Amazon Fire OS joue la valeur par défaut le **Son de Notification** spécifié sous le panneau **d'affichage des réglages/& Sound** .
234
235 ### Quirks Android
236
237 * Android joue la **sonnerie de Notification** spécifié sous le panneau des **réglages/son et affichage** de valeur par défaut.
238
239 ### Windows Phone 7 et 8 Quirks
240
241 * S'appuie sur un fichier générique bip de la distribution de Cordova.
242
243 ### Bizarreries de paciarelli
244
245 * Paciarelli implémente les bips en lisant un fichier audio via les médias API.
246
247 * Le fichier sonore doit être court, doit se trouver dans un `sounds` sous-répertoire du répertoire racine de l'application et doit être nommé`beep.wav`.

mercurial