Script dialogues.js

Le script dialogues.js permet d'afficher et de récupérer le résultat des boîtes de dialogue les plus utilisées.

Ce script contrôle quatre types de boîtes de dialogue :

• le dialogue d'information (ou d'avertissement) ;
• le dialogue de confirmation (ou de question) ;
• le dialogue de saisie ;
• le dialogue d'impression de la page.

Pour chaque type de dialogue, le script fournit une fonction qui affiche le dialogue souhaité et en retourne le résultat lorsque celui-ci existe.

Depuis :

JsLib 1.0

dialogueConfirm

booléen dialogueConfirm(chaîne message)

Affiche une boîte de dialogue de confirmation et retourne la réponse choisie. La boîte de dialogue dispose de deux boutons : OK et Annuler. Le message spécifié est celui qui s'affichera dans la boîte de dialogue ; il s'agit généralement d'une question. La fonction retourne un booléen en fonction du bouton sur lequel l'utilisateur a cliqué.

Paramètres :

message - le message affiché par la boîte de dialogue.

Retourne :

true si l'utilisateur a cliqué sur OK, false sinon.

dialogueImprimer

dialogueImprimer()

Affiche la boîte de dialogue d'impression de la page Web courante. La boîte de dialogue qui s'affiche dépend du système sur lequel est installé le navigateur. Elle permet généralement de choisir l'imprimante à utiliser pour l'impression, le nombre de copies à imprimer, etc.

dialogueInfo

dialogueInfo(chaîne message)

Affiche une boîte de dialogue d'information. Le message spécifié est celui qui s'affichera dans la boîte de dialogue ; il s'agit généralement d'un avertissement ou d'un message d'erreur.

Paramètres :

message - le message affiché par la boîte de dialogue.

dialogueSaisie

chaîne dialogueSaisie(chaîne message, chaîne defaut)

Affiche une boîte de dialogue de saisie et retourne le texte saisi. La boîte de dialogue dispose d'au moins deux boutons : OK et Annuler. Le message spécifié est celui qui s'affichera dans la boîte de dialogue ; il s'agit généralement d'une question. La valeur par défaut spécifiée est affichée dans le champ de saisie lorsque la boîte de dialogue apparaît. Si elle est omise, le champ de saisie est vide. La fonction retourne la valeur saisie par l'utilisateur sous la forme d'une chaîne de caractères.

Paramètres :

message - le message affiché par la boîte de dialogue.

defaut - la valeur par défaut du champ de saisie.

Retourne :

la chaîne de caractères saisie par l'utilisateur.