Aller au contenu principal

Toast

Ouvrir dans ChatGPT
Shadow dwc-toast 24.10
Java API

Une notification Toast est une notification subtile et discrète conçue pour fournir aux utilisateurs des retours d'information et des informations en temps réel. Ces notifications sont généralement utilisées pour informer les utilisateurs d'opérations telles que des actions réussies, des avertissements ou des erreurs sans interrompre leur flux de travail. Les notifications Toast disparaissent généralement après un certain temps défini et ne nécessitent pas de réponse de l'utilisateur.

Avec le composant Toast de webforJ, vous pouvez facilement mettre en œuvre ces notifications pour améliorer l'expérience utilisateur en fournissant des informations pertinentes de manière familière, non intrusive et fluide.

Basics

webforJ propose un moyen rapide et facile de créer un composant Toast en une seule ligne de code avec la méthode Toast.show(), qui crée un composant Toast, l'ajoute au Frame et l'affiche. Vous pouvez passer des paramètres à la méthode show pour configurer le Toast affiché :

Toast.show("Opération réussie !", Theme.SUCCESS);

Si vous souhaitez un meilleur contrôle 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("Opération réussie !", 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 ajouté explicitement à 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 comme les soumissions de formulaires, les sauvegardes de données ou les erreurs.
  • Thèmes personnalisables pour différencier entre les messages de réussite, 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.

Duration

Vous pouvez configurer les notifications Toast pour disparaître après une durée définie ou persister à 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 les cas où une interaction ou une reconnaissance est requise de la part de l'utilisateur.

attention

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 terminé toute interaction requise.

Toast toast = new Toast("Opération réussie !", -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 répondre aux exigences de conception et d'ergonomie de votre application. Par défaut, les notifications Toast apparaissent au centre en bas 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'ergonomie 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 en fonction de votre application, de la mise en page de l'écran et du contexte.

Stacking

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, poussant 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 la part 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 précieux d'interaction et d'engagement.

Styling

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'informations affichées et créant un style cohérent dans toute votre application. Vous pouvez soit définir le thème lorsque vous créez le 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 démontre comment créer un Toast avec un thème personnalisé en utilisant webforJ.

Ciblage du Toast

Comme le Toast n'est pas situé à un endroit 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 sur toutes les notifications Toast.

Afficher le code

Loading...