droidcon: Touchgui/plugins/org.apache.cordova.dialogs/doc/fr/index.md@e8ccd40d0ef6

     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 Ce plugin permet d'accéder à certains éléments d'interface utilisateur native de dialogue.

    24 ## Installation

    26     cordova plugin add org.apache.cordova.dialogs

    29 ## Méthodes

    31 *   `navigator.notification.alert`

    32 *   `navigator.notification.confirm`

    33 *   `navigator.notification.prompt`

    34 *   `navigator.notification.beep`

    36 ## navigator.notification.alert

    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.

    40     Navigator.notification.Alert (message, alertCallback, [titre], [buttonName])

    43 *   **message**: message de la boîte de dialogue. *(String)*

    45 *   **alertCallback**: callback à appeler lorsque la boîte de dialogue d'alerte est rejetée. *(Fonction)*

    47 *   **titre**: titre de la boîte de dialogue. *(String)* (Facultatif, par défaut`Alert`)

    49 *   **buttonName**: nom du bouton. *(String)* (Facultatif, par défaut`OK`)

    51 ### Exemple

    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 ### Plates-formes prises en charge

    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

    76 ### Windows Phone 7 et 8 Quirks

    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:

    80         window.alert = navigator.notification.alert;

    83 *   Les deux appels `alert` et `confirm` sont non-blocants, leurs résultats ne sont disponibles que de façon asynchrone.

    85 ### Firefox OS Quirks :

    87 Les deux indigènes bloquant `window.alert()` et non-bloquante `navigator.notification.alert()` sont disponibles.

    89 ## navigator.notification.confirm

    91 Affiche une boîte de dialogue de confirmation personnalisable.

    93     navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])

    96 *   **message**: message de la boîte de dialogue. *(String)*

    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)*

   100 *   **titre**: titre de dialogue. *(String)* (Facultatif, par défaut`Confirm`)

   102 *   **buttonLabels**: tableau de chaînes spécifiant les étiquettes des boutons. *(Array)* (Optionnel, par défaut, [ `OK,Cancel` ])

   104 ### confirmCallback

   106 Le `confirmCallback` s'exécute lorsque l'utilisateur appuie sur un bouton dans la boîte de dialogue de confirmation.

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

   110 ### Exemple

   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 ### Plates-formes prises en charge

   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

   135 ### Windows Phone 7 et 8 Quirks

   137 *   Il n'y a aucune fonction intégrée au navigateur pour `window.confirm`, mais vous pouvez en lier une en affectant:

   139         window.confirm = navigator.notification.confirm ;

   142 *   Les appels à `alert` et `confirm` sont non-bloquants, donc le résultat est seulement disponible de façon asynchrone.

   144 ### Firefox OS Quirks :

   146 Les deux indigènes bloquant `window.confirm()` et non-bloquante `navigator.notification.confirm()` sont disponibles.

   148 ## navigator.notification.prompt

   150 Affiche une boîte de dialogue natif qui est plus personnalisable que le navigateur `prompt` fonction.

   152     navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])

   155 *   **message**: message de la boîte de dialogue. *(String)*

   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)*

   159 *   **titre**: titre de la boîte de dialogue. *(String)* (Facultatif, par défaut`Alert`)

   161 *   **buttonLabels**: tableau de chaînes spécifiant les étiquettes de boutons *(Array)* (facultatif, par défaut, les étiquettes `["OK","Cancel"]`)

   163 *   **defaultText**: texte par défaut de la zone de texte ( `String` ) (en option, par défaut : chaîne vide)

   165 ### promptCallback

   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 :

   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.

   171 *   **entrée 1**: le texte entré dans la boîte de dialogue d'invite. *(String)*

   173 ### Exemple

   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 ### Plates-formes prises en charge

   190 *   Amazon Fire OS

   191 *   Android

   192 *   Firefox OS

   193 *   iOS

   194 *   Windows Phone 7 et 8

   196 ### Quirks Android

   198 *   Android prend en charge un maximum de trois boutons et ignore plus que cela.

   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.

   202 ### Firefox OS Quirks :

   204 Les deux indigènes bloquant `window.prompt()` et non-bloquante `navigator.notification.prompt()` sont disponibles.

   206 ## navigator.notification.beep

   208 Le dispositif joue un bip sonore.

   210     navigator.notification.beep(times);

   213 *   **temps**: le nombre de fois répéter le bip. *(Nombre)*

   215 ### Exemple

   217     // Beep twice!

   218     navigator.notification.beep(2);

   221 ### Plates-formes prises en charge

   223 *   Amazon Fire OS

   224 *   Android

   225 *   BlackBerry 10

   226 *   iOS

   227 *   Paciarelli

   228 *   Windows Phone 7 et 8

   229 *   Windows 8

   231 ### Amazon Fire OS Quirks

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

   235 ### Quirks Android

   237 *   Android joue la **sonnerie de Notification** spécifié sous le panneau des **réglages/son et affichage** de valeur par défaut.

   239 ### Windows Phone 7 et 8 Quirks

   241 *   S'appuie sur un fichier générique bip de la distribution de Cordova.

   243 ### Bizarreries de paciarelli

   245 *   Paciarelli implémente les bips en lisant un fichier audio via les médias API.

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

droidcon / file revision

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

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