Passer au contenu principal

Toast

Ouvrir dans ChatGPT
Ombre dwc-toast 24.10
Java API

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

Basique​

webforJ fournit 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("L'opération s'est terminée avec succès !", Theme.SUCCESS);

Si vous souhaitez un contrôle plus granulaire 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 en temps réel. Par exemple :

  • Retour en temps réel pour des actions comme des soumissions de formulaires, des sauvegardes de données ou des 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éterminée ou persister à l'écran jusqu'à ce qu'elles soient rejetées, en fonction de 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 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 de 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 de l'utilisateur est requise.

précaution

Faites attention avec les notifications Toast persistantes, et assurez-vous de fournir un moyen pour 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("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 à l'écran pour répondre aux exigences de conception et d'utilisabilité de votre application. Par défaut, les notifications Toast apparaissent au centre 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 au centre bas 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 au centre haut 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 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 d'une manière qui convient à toute application, mise en page d'écran et contexte donnés.

Empilage​

Le composant Toast peut afficher plusieurs notifications simultanément, les empilant verticalement en fonction de leur placement. Les notifications plus récentes 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 y a beaucoup d'activités en cours.

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.

Styles​

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 Exemple", Theme.INFO);
Toast toast = new Toast("Notification 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 des Toast

Puisque le Toast n'est pas situé à un endroit spécifique dans le DOM, vous pouvez le cibler en utilisant des variables CSS. Ces variables facilitent l'application de styles personnalisés cohérents à toutes les notifications Toast.

Afficher le code

Loading...