Passer au contenu principal

Message

Ouvrir dans ChatGPT
Ombre 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.

Usages​

Utilisez la méthode statique showMessageDialog pour afficher un message de base.

OptionDialog.showMessageDialog("Bonjour le monde !");

Pour un meilleur contrôle sur l'apparence et le comportement de la boîte de dialogue, créez directement une instance de MessageDialog.

MessageDialog dialog = new MessageDialog(
  "Bonjour le monde", "Bonjour le monde", MessageDialog.MessageType.INFO);
dialog.setBlurred(true);
dialog.setAlignment(MessageDialog.Alignment.TOP);
dialog.show();

Type de message​

Le MessageDialog prend en charge les types de messages 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'information à côté du message, en utilisant le thème d'information.

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

Texte du bouton​

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

OptionDialog.showMessageDialog("Bonjour le monde !", "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 configurant l'affichage du texte brut à la place.

MessageDialog dialog = new MessageDialog(
  "<b>Bonjour le monde</b>", "Bonjour le monde", 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 des notifications ou des informations non critiques qui ne nécessitent pas l'interaction immédiate de l'utilisateur.

Vous pouvez configurer le délai d'expiration pour la boîte de dialogue en utilisant la méthode setTimeout(int timeout). La durée du délai d'expiration 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 expirer bientôt", "Délai d'expiration");
dialog.setTimeout(2);
dialog.show();

Meilleures pratiques​

  1. Messages clairs et concis : Gardez les messages courts et pertinents et évitez le jargon technique ; utilisez un langage accessible aux utilisateurs.
  2. Types de messages appropriés :
    • Utilisez ERROR pour les problèmes critiques.
    • Utilisez WARNING pour les avis de précaution.
    • 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'expiration : Définissez des délais d'expiration pour les notifications non critiques et veillez à ce que les utilisateurs aient suffisamment de temps pour lire le message.
  5. Évitez l'utilisation excessive : Utilisez les boîtes de dialogue avec parcimonie pour éviter la frustration des utilisateurs et réservez-les pour des messages importants nécessitant une action ou une reconnaissance de l'utilisateur.