Aller au contenu principal

Dialogue de message

Ouvrir dans ChatGPT
Shadow 24.02
Java API

Un MessageDialog est une boîte de dialogue modale conçue pour afficher un message à l'utilisateur avec un bouton OK pour fermer la boîte de dialogue. Elle bloque l'exécution de l'application jusqu'à ce que l'utilisateur interagisse avec elle ou qu'elle se ferme en raison d'un délai d'expiration.

OptionDialog.showMessageDialog("Hello World!");

Utilisations

Le Dialogue de message offre un moyen d'afficher des alertes informatives, telles que des notifications, des mises à jour ou des messages simples qui ne nécessitent que la reconnaissance de l'utilisateur sans fournir d'entrée.

MessageDialog dialog = new MessageDialog(
"Hello World", "Hello World", MessageDialog.MessageType.INFO);
dialog.setBlurred(true);
dialog.setAlignment(MessageDialog.Alignment.TOP);
dialog.show();

Type de message

Le MessageDialog prend en charge les types de message suivants. Lorsque vous configurez un type, la boîte de dialogue affiche une icône à côté du message, et le thème de la boîte de dialogue se met à jour selon les règles du système de design webforJ.

  1. PLAIN: Affiche le message sans icône, en utilisant le thème par défaut.
  2. ERROR: Affiche une icône d'erreur à côté du message avec le thème d'erreur appliqué.
  3. QUESTION: Affiche une icône de point d'interrogation à côté du message, en utilisant le thème principal.
  4. WARNING: Affiche une icône d'avertissement à côté du message avec le thème d'avertissement appliqué.
  5. INFO: Affiche une icône d'info à côté du message, en utilisant le thème d'info.

Dans l'exemple suivant, le code configure une boîte de dialogue de message de type WARNING, avec un titre et un message personnalisés.

Afficher le code

Thème de la boîte de dialogue et du bouton

Par défaut, la boîte de dialogue détermine le thème en fonction du type de message. Vous pouvez personnaliser le thème de la boîte de dialogue en utilisant la méthode setTheme(Theme theme) et ajuster indépendamment le thème du bouton avec la méthode setButtonTheme(ButtonTheme theme) pour créer différentes variations.

Texte du bouton

Vous pouvez configurer le texte du bouton de la boîte de dialogue en utilisant la méthode setButtonText(String text).

OptionDialog.showMessageDialog("Hello World!", "Titre", "Compris");

Traitement HTML

Par défaut, la boîte de dialogue de message traite et rend le contenu HTML. Vous pouvez désactiver cette fonctionnalité en la configurant pour afficher du texte brut à la place.

MessageDialog dialog = new MessageDialog(
"<b>Hello World</b>", "Hello World", MessageDialog.MessageType.INFO);
dialog.setRawText(true);
dialog.show();

Délai d'expiration

Le MessageDialog vous permet de définir une durée de délai d'expiration après laquelle la boîte de dialogue se ferme automatiquement. Cette fonctionnalité est utile pour les notifications non critiques ou les informations qui ne nécessitent pas l'interaction immédiate de l'utilisateur.

Vous pouvez configurer le délai pour la boîte de dialogue en utilisant la méthode setTimeout(int timeout). La durée du délai est en secondes. Si le temps spécifié s'écoule sans aucune interaction de l'utilisateur, la boîte de dialogue se ferme automatiquement.

MessageDialog dialog = new MessageDialog("Cette boîte de dialogue va bientôt expirer", "Délai d'expiration");
dialog.setTimeout(2);
dialog.show();

Meilleures pratiques

  1. Messages clairs et concis: Gardez les messages courts et précis et évitez le jargon technique ; utilisez un langage convivial.
  2. Types de messages appropriés :
    • Utilisez ERROR pour des problèmes critiques.
    • Utilisez WARNING pour des avis de prudence.
    • Utilisez INFO pour des informations générales.
  3. Thématisation cohérente: Alignez les thèmes de la boîte de dialogue et du bouton avec le design de votre application.
  4. Utilisation judicieuse du délai: Définissez des délais pour les notifications non critiques et assurez-vous que les utilisateurs ont suffisamment de temps pour lire le message.
  5. Évitez la surutilisation: Utilisez les boîtes de dialogue avec parcimonie pour éviter la frustration des utilisateurs et réservez-les pour les messages importants nécessitant une action ou une reconnaissance de l'utilisateur.