Toast
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 succès, des avertissements ou des erreurs sans interrompre le flux de travail actuel, et disparaissent automatiquement après une durée déterminée.
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();
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 offrent des notifications discrètes 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, l'enregistrement 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 des 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, 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().
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.
Soyez prudent avec les notifications Toast persistantes, et assurez-vous de fournir un moyen pour l'utilisateur de fermer la notification. Utilisez la méthode close() pour masquer le Toast une fois que l'utilisateur l'a reconnu ou a terminé toute interaction nécessaire.
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 correspondre aux exigences de design 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 au bas du 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.
- CENTER : Place la notification au centre 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 votre application en matière de design et d'utilisabilité.
Toast toast = new Toast("Notification d'exemple");
toast.setPlacement(Toast.Placement.TOP_LEFT);
toast.open();
En personnalisant le placement de vos notifications Toast, vous pouvez vous assurer que les utilisateurs reçoivent les informations de manière appropriée pour toute application, mise en page d'écran et contexte donnés.
Empilement
Le composant Toast peut afficher plusieurs notifications simultanément, en 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 y a beaucoup de choses en cours.
Actions et interactivité
Bien que les notifications Toast ne nécessitent pas d'interaction 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.
En ajoutant ce type d'interactivité, vous pouvez donner aux utilisateurs la possibilité de gérer des tâches et de réaliser des actions sans quitter leur écran actuel, transformant ainsi une notification Toast en un précieux canal d'interaction et d'engagement.
Style
Vous pouvez styliser les notifications Toast avec des thèmes tout comme d'autres composants de 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 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 démontre comment créer un Toast avec un thème personnalisé en utilisant webforJ.
ToastÉtant donné que le Toast n'est pas situé dans 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 sur toutes les notifications Toast.
