michael@0: <!---
michael@0:     Licensed to the Apache Software Foundation (ASF) under one
michael@0:     or more contributor license agreements.  See the NOTICE file
michael@0:     distributed with this work for additional information
michael@0:     regarding copyright ownership.  The ASF licenses this file
michael@0:     to you under the Apache License, Version 2.0 (the
michael@0:     "License"); you may not use this file except in compliance
michael@0:     with the License.  You may obtain a copy of the License at
michael@0: 
michael@0:       http://www.apache.org/licenses/LICENSE-2.0
michael@0: 
michael@0:     Unless required by applicable law or agreed to in writing,
michael@0:     software distributed under the License is distributed on an
michael@0:     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0:     KIND, either express or implied.  See the License for the
michael@0:     specific language governing permissions and limitations
michael@0:     under the License.
michael@0: -->
michael@0: 
michael@0: # org.apache.cordova.dialogs
michael@0: 
michael@0: Ce plugin permet d'accéder à certains éléments d'interface utilisateur native de dialogue.
michael@0: 
michael@0: ## Installation
michael@0: 
michael@0:     cordova plugin add org.apache.cordova.dialogs
michael@0:     
michael@0: 
michael@0: ## Méthodes
michael@0: 
michael@0: *   `navigator.notification.alert`
michael@0: *   `navigator.notification.confirm`
michael@0: *   `navigator.notification.prompt`
michael@0: *   `navigator.notification.beep`
michael@0: 
michael@0: ## navigator.notification.alert
michael@0: 
michael@0: 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.
michael@0: 
michael@0:     Navigator.notification.Alert (message, alertCallback, [titre], [buttonName])
michael@0:     
michael@0: 
michael@0: *   **message**: message de la boîte de dialogue. *(String)*
michael@0: 
michael@0: *   **alertCallback**: callback à appeler lorsque la boîte de dialogue d'alerte est rejetée. *(Fonction)*
michael@0: 
michael@0: *   **titre**: titre de la boîte de dialogue. *(String)* (Facultatif, par défaut`Alert`)
michael@0: 
michael@0: *   **buttonName**: nom du bouton. *(String)* (Facultatif, par défaut`OK`)
michael@0: 
michael@0: ### Exemple
michael@0: 
michael@0:     function alertDismissed() {
michael@0:         // do something
michael@0:     }
michael@0:     
michael@0:     navigator.notification.alert(
michael@0:         'You are the winner!',  // message
michael@0:         alertDismissed,         // callback
michael@0:         'Game Over',            // title
michael@0:         'Done'                  // buttonName
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Plates-formes prises en charge
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 et 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Windows Phone 7 et 8 Quirks
michael@0: 
michael@0: *   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:
michael@0:     
michael@0:         window.alert = navigator.notification.alert;
michael@0:         
michael@0: 
michael@0: *   Les deux appels `alert` et `confirm` sont non-blocants, leurs résultats ne sont disponibles que de façon asynchrone.
michael@0: 
michael@0: ### Firefox OS Quirks :
michael@0: 
michael@0: Les deux indigènes bloquant `window.alert()` et non-bloquante `navigator.notification.alert()` sont disponibles.
michael@0: 
michael@0: ## navigator.notification.confirm
michael@0: 
michael@0: Affiche une boîte de dialogue de confirmation personnalisable.
michael@0: 
michael@0:     navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
michael@0:     
michael@0: 
michael@0: *   **message**: message de la boîte de dialogue. *(String)*
michael@0: 
michael@0: *   **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)*
michael@0: 
michael@0: *   **titre**: titre de dialogue. *(String)* (Facultatif, par défaut`Confirm`)
michael@0: 
michael@0: *   **buttonLabels**: tableau de chaînes spécifiant les étiquettes des boutons. *(Array)* (Optionnel, par défaut, [ `OK,Cancel` ])
michael@0: 
michael@0: ### confirmCallback
michael@0: 
michael@0: Le `confirmCallback` s'exécute lorsque l'utilisateur appuie sur un bouton dans la boîte de dialogue de confirmation.
michael@0: 
michael@0: 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..
michael@0: 
michael@0: ### Exemple
michael@0: 
michael@0:     function onConfirm(buttonIndex) {
michael@0:         alert('You selected button ' + buttonIndex);
michael@0:     }
michael@0:     
michael@0:     navigator.notification.confirm(
michael@0:         'You are the winner!', // message
michael@0:          onConfirm,            // callback to invoke with index of button pressed
michael@0:         'Game Over',           // title
michael@0:         ['Restart','Exit']     // buttonLabels
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Plates-formes prises en charge
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Paciarelli
michael@0: *   Windows Phone 7 et 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Windows Phone 7 et 8 Quirks
michael@0: 
michael@0: *   Il n'y a aucune fonction intégrée au navigateur pour `window.confirm`, mais vous pouvez en lier une en affectant:
michael@0:     
michael@0:         window.confirm = navigator.notification.confirm ;
michael@0:         
michael@0: 
michael@0: *   Les appels à `alert` et `confirm` sont non-bloquants, donc le résultat est seulement disponible de façon asynchrone.
michael@0: 
michael@0: ### Firefox OS Quirks :
michael@0: 
michael@0: Les deux indigènes bloquant `window.confirm()` et non-bloquante `navigator.notification.confirm()` sont disponibles.
michael@0: 
michael@0: ## navigator.notification.prompt
michael@0: 
michael@0: Affiche une boîte de dialogue natif qui est plus personnalisable que le navigateur `prompt` fonction.
michael@0: 
michael@0:     navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
michael@0:     
michael@0: 
michael@0: *   **message**: message de la boîte de dialogue. *(String)*
michael@0: 
michael@0: *   **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)*
michael@0: 
michael@0: *   **titre**: titre de la boîte de dialogue. *(String)* (Facultatif, par défaut`Alert`)
michael@0: 
michael@0: *   **buttonLabels**: tableau de chaînes spécifiant les étiquettes de boutons *(Array)* (facultatif, par défaut, les étiquettes `["OK","Cancel"]`)
michael@0: 
michael@0: *   **defaultText**: texte par défaut de la zone de texte ( `String` ) (en option, par défaut : chaîne vide)
michael@0: 
michael@0: ### promptCallback
michael@0: 
michael@0: 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 :
michael@0: 
michael@0: *   **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.
michael@0: 
michael@0: *   **entrée 1**: le texte entré dans la boîte de dialogue d'invite. *(String)*
michael@0: 
michael@0: ### Exemple
michael@0: 
michael@0:     function onPrompt(results) {
michael@0:         alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
michael@0:     }
michael@0:     
michael@0:     navigator.notification.prompt(
michael@0:         'Please enter your name',  // message
michael@0:         onPrompt,                  // callback to invoke
michael@0:         'Registration',            // title
michael@0:         ['Ok','Exit'],             // buttonLabels
michael@0:         'Jane Doe'                 // defaultText
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Plates-formes prises en charge
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Windows Phone 7 et 8
michael@0: 
michael@0: ### Quirks Android
michael@0: 
michael@0: *   Android prend en charge un maximum de trois boutons et ignore plus que cela.
michael@0: 
michael@0: *   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.
michael@0: 
michael@0: ### Firefox OS Quirks :
michael@0: 
michael@0: Les deux indigènes bloquant `window.prompt()` et non-bloquante `navigator.notification.prompt()` sont disponibles.
michael@0: 
michael@0: ## navigator.notification.beep
michael@0: 
michael@0: Le dispositif joue un bip sonore.
michael@0: 
michael@0:     navigator.notification.beep(times);
michael@0:     
michael@0: 
michael@0: *   **temps**: le nombre de fois répéter le bip. *(Nombre)*
michael@0: 
michael@0: ### Exemple
michael@0: 
michael@0:     // Beep twice!
michael@0:     navigator.notification.beep(2);
michael@0:     
michael@0: 
michael@0: ### Plates-formes prises en charge
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   iOS
michael@0: *   Paciarelli
michael@0: *   Windows Phone 7 et 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Amazon Fire OS Quirks
michael@0: 
michael@0: *   Amazon Fire OS joue la valeur par défaut le **Son de Notification** spécifié sous le panneau **d'affichage des réglages/& Sound** .
michael@0: 
michael@0: ### Quirks Android
michael@0: 
michael@0: *   Android joue la **sonnerie de Notification** spécifié sous le panneau des **réglages/son et affichage** de valeur par défaut.
michael@0: 
michael@0: ### Windows Phone 7 et 8 Quirks
michael@0: 
michael@0: *   S'appuie sur un fichier générique bip de la distribution de Cordova.
michael@0: 
michael@0: ### Bizarreries de paciarelli
michael@0: 
michael@0: *   Paciarelli implémente les bips en lisant un fichier audio via les médias API.
michael@0: 
michael@0: *   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`.