Passer au contenu principal

Toast

Ouvrir dans ChatGPT
Ombre dwc-toast 24.10
Java API

Un Toast est une notification temporaire et de petite taille qui apparaît pour donner aux utilisateurs un retour d'information sur une action ou un événement. Les toasts affichent des messages de confirmation de succès, d'avertissements ou d'erreurs sans interrompre le flux de travail actuel et disparaissent automatiquement après une durée définie.

La méthode Toast.show() crée un Toast, l'ajoute au Frame et l'affiche en une seule ligne de code. Passez des paramètres à show() pour configurer le Toast qui apparaît :

Toast.show("L'opération s'est terminée avec succès !", Theme.SUCCESS);

Si vous souhaitez un contrôle plus précis sur le composant, vous pouvez également créer un Toast avec un constructeur standard et utiliser la méthode open() pour l'afficher.

Toast toast = new Toast("L'opération s'est terminée avec succès !", 3000, Theme.SUCCESS, Placement.TOP);
toast.open();
Afficher le code

Comportement par défaut

Contrairement à d'autres composants, un Toast n'a pas besoin d'être explicitement ajouté à un conteneur comme un Frame. Lorsque vous appelez la méthode open(), le Toast est automatiquement attaché au premier Frame de l'application.

Les toasts sont polyvalents et fournissent des notifications subtiles pour un retour d'information en temps réel. Par exemple :

  • Retour d'information en temps réel pour des actions telles que l'envoi de formulaires, les sauvegardes de données ou les erreurs.
  • Thèmes personnalisables pour différencier les messages de succès, d'erreur, d'avertissement ou d'information.
  • Options de placement flexibles pour afficher les notifications dans différentes zones de l'écran sans interrompre le flux de travail de l'utilisateur.

Durée​

Vous pouvez configurer les notifications Toast pour disparaître après une durée définie ou persister sur l'écran jusqu'à ce qu'elles soient rejetées, selon vos besoins. Vous pouvez personnaliser la durée avec la méthode setDuration(), ou simplement fournir un paramètre de durée au constructeur ou à la méthode show().

Durée par défaut

Par défaut, un Toast se ferme automatiquement après 5000 millisecondes.

Toast toast = new Toast("Notification d'exemple");
toast.setDuration(10000);
toast.open();

Toasts persistants​

Vous pouvez créer un Toast persistant en définissant une durée négative. Les notifications Toast persistantes ne se ferment pas automatiquement, ce qui peut être utile pour des alertes critiques ou dans des cas où une interaction ou une reconnaissance est requise de la part de l'utilisateur.

précaution

Soyez prudent avec les notifications Toast persistantes et assurez-vous de fournir un moyen à l'utilisateur de rejeter la notification. Utilisez la méthode close() pour cacher le Toast une fois que l'utilisateur l'a reconnu ou a complété toute interaction requise.

Toast toast = new Toast("L'opération s'est terminée avec succès !", -1, Theme.SUCCESS, Placement.TOP);
toast.open();

Placement​

Avec le composant Toast de webforJ, vous pouvez choisir où la notification apparaît sur l'écran pour s'adapter aux exigences de conception et d'utilisabilité de votre application. Par défaut, les notifications Toast apparaissent en bas au centre de l'écran.

Vous pouvez définir le placement d'une notification Toast avec la méthode setPlacement en utilisant l'énumération Toast.Placement avec l'une des valeurs suivantes :

  • BOTTOM : Place la notification en bas au centre de l'écran.
  • BOTTOM_LEFT : Place la notification dans le coin inférieur gauche de l'écran.
  • BOTTOM_RIGHT : Place la notification dans le coin inférieur droit de l'écran.
  • TOP : Place la notification en haut au centre de l'écran.
  • TOP_LEFT : Place la notification dans le coin supérieur gauche de l'écran.
  • TOP_RIGHT : Place la notification dans le coin supérieur droit de l'écran.

Ces options vous permettent de contrôler le placement de la notification Toast en fonction des besoins de conception et d'utilisabilité de votre application.

Toast toast = new Toast("Notification d'exemple");
toast.setPlacement(Toast.Placement.TOP_LEFT);
toast.open();
Afficher le code

En personnalisant le placement de vos notifications Toast, vous pouvez vous assurer que les utilisateurs reçoivent des informations de manière appropriée pour toute application, mise en page d'écran et contexte donné.

Empilement​

Le composant Toast peut afficher plusieurs notifications simultanément, les empilant verticalement en fonction de leur placement. Les nouvelles notifications apparaissent plus près du bord de placement, repoussant les notifications plus anciennes plus loin. Cela garantit que les utilisateurs ne manquent pas d'informations importantes, même lorsqu'il se passe beaucoup de choses.

Actions et interactivité​

Bien que les notifications Toast ne nécessitent pas d'interaction de l'utilisateur par défaut, webforJ vous permet d'ajouter des boutons ou d'autres éléments interactifs pour les rendre plus utiles que de simples notifications.

Afficher le code

En ajoutant ce type d'interactivité, vous pouvez donner aux utilisateurs la possibilité de gérer des tâches et d'effectuer des actions sans quitter leur écran actuel, transformant une notification Toast en un canal d'interaction et d'engagement précieux.

Style​

Vous pouvez styliser les notifications Toast avec des thèmes tout comme d'autres composants webforJ, fournissant aux utilisateurs un contexte précieux sur le type d'information affichée et créant un style cohérent dans toute votre application. Vous pouvez soit définir le thème lors de la création du Toast, soit utiliser la méthode setTheme().

Toast toast = new Toast("Notification d'exemple", Theme.INFO);
Toast toast = new Toast("Notification d'exemple");
toast.setTheme(Theme.INFO);

Thèmes personnalisés​

En plus d'utiliser des thèmes intégrés, vous pouvez créer vos propres thèmes personnalisés pour les notifications Toast. Cela permet une expérience utilisateur plus personnalisée et de marque, vous donnant un contrôle total sur le style global du Toast.

Pour ajouter un thème personnalisé à un Toast, vous pouvez définir des variables CSS personnalisées, qui modifient l'apparence du composant. L'exemple suivant montre comment créer un Toast avec un thème personnalisé en utilisant webforJ.

Ciblage de Toast

Puisque le Toast n'est pas situé à une position spécifique dans le DOM, vous pouvez le cibler à l'aide de variables CSS. Ces variables facilitent l'application de styles personnalisés cohérents à tous les notifications Toast.

Afficher le code

Loading...