Toast

  • Article

Toast est une alerte périodique qui s’affiche au bas de l’écran. Elle disparaît automatiquement au bout d’un certain temps configurable.

Elle fournit des commentaires simples à l’utilisateur sur une opération dans une petite alerte.

Syntaxe

C#

Pour afficher Toast, commencez par le créer à l’aide de la méthode statique Toast.Make(), puis affichez-le à l’aide de sa méthode Show().

using CommunityToolkit.Maui.Alerts;

CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();

string text = "This is a Toast";
ToastDuration duration = ToastDuration.Short;
double fontSize = 14;

var toast = Toast.Make(text, duration, fontSize);

await toast.Show(cancellationTokenSource.Token);

Lors de l’appel de Toast.Make(), son paramètre string text est requis. Tous les autres paramètres sont facultatifs. Son paramètre facultatif ToastDuration duration utilise la durée par défaut de ToastDuration.Short. Son paramètre facultatif double fontSize utilise la valeur par défaut de 14.0.

La capture d’écran suivante montre le Toast obtenu :

Propriétés

Propriété Type Description Valeur par défaut
Détails string Texte affiché dans le Toast. Obligatoire
Durée ToastDuration Durée Toast affichée. ToastDuration.Short
TextSize double Taille de police du texte. 14.0

ToastDuration

L’énumération ToastDuration définit les membres suivants :

  • Short – Afficher Toast pendant 2 secondes
  • Long – Afficher Toast pendant 3,5 secondes

Ces valeurs respectent les constantes définies dans l’API android.widget.Toast.

Méthodes

méthode Description
Afficher Affichez le Toast demandé. Si un Toast est actuellement affiché, il est automatiquement ignoré avant l’affichage du Toast demandé.
Ignorer Ignorer la notification Toast actuelle.

Remarque

Vous ne pouvez afficher qu’un seul Toast à la fois. Si vous appelez la méthode Show une deuxième fois, le premier Toast est automatiquement ignoré.

Exemples

Vous trouverez un exemple de cette fonctionnalité en action dans l’exemple d’application du kit d’outils de la communauté .NET MAUI.

API

Vous pouvez trouver le code source deToast sur le référentiel du kit de ressources de la communauté .NET MAUI sur GitHub.

Détails de l’implémentation et de la limitation pour différentes plateformes

  1. L’API permet de remplacer les méthodes existantes par votre propre implémentation ou de créer votre propre toast, en implémentant l’interface IToast.
  2. Toast est implémenté sur Android, créé par Google. D’autres plateformes utilisent un conteneur implémenté personnalisé (UIView pour iOS et MacCatalyst, ToastNotification sur Windows).
  3. Toast sur Tizen ne peut pas être personnalisé avec ses propriétés Duration et TextSize.