Sdílet prostřednictvím


Snackbar

Ve Snackbar výchozím nastavení se zobrazí časové upozornění, které se zobrazí v dolní části obrazovky. Zavře se po konfigurovatelné době. Snackbar je plně přizpůsobitelná a lze ji ukotvit na libovolnou IView.

Informuje Snackbar uživatele o procesu, který aplikace provedla nebo provede. Zobrazí se dočasně v dolní části obrazovky.

Inicializace specifická pro platformu

Pro přístup k funkcím Snackbar se vyžaduje následující nastavení specifické pro platformu.

Není vyžadováno žádné nastavení.

Syntaxe

Vyvolá se pomocí jazyka Snackbar C#.

C#

Pokud ho chcete zobrazit Snackbar , musíte ho vytvořit pomocí statické metody Make:

using CommunityToolkit.Maui.Alerts;

CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();

var snackbarOptions = new SnackbarOptions
{
    BackgroundColor = Colors.Red,
    TextColor = Colors.Green,
    ActionButtonTextColor = Colors.Yellow,
    CornerRadius = new CornerRadius(10),
    Font = Font.SystemFontOfSize(14),
    ActionButtonFont = Font.SystemFontOfSize(14),
    CharacterSpacing = 0.5
};

string text = "This is a Snackbar";
string actionButtonText = "Click Here to Dismiss";
Action action = async () => await DisplayAlert("Snackbar ActionButton Tapped", "The user has tapped the Snackbar ActionButton", "OK");
TimeSpan duration = TimeSpan.FromSeconds(3);

var snackbar = Snackbar.Make(text, action, actionButtonText, duration, snackbarOptions);

await snackbar.Show(cancellationTokenSource.Token);

Při volání Snackbar.Make()se vyžaduje jeho parametr string text . Všechny ostatní parametry jsou volitelné.

Následující snímek obrazovky ukazuje výsledný snackbar:

K dispozici je také rozšiřující metoda, která ukotví jakoukoli VisualElementmetoduSnackbar:

await MyVisualElement.DisplaySnackbar("Snackbar is awesome. It is anchored to MyVisualElement");

Upozorňující

Snackbar ve Windows nelze ukotvit VisualElement a vždy se zobrazí jako výchozí oznámení systému Windows.

SnackBar obsahuje dvě události:

  • public static event EventHandler Shown
  • public static event EventHandler Dismissed

Obsahuje také vlastnost public static bool IsShown { get; }.

Snackbar.Shown += (s, e) => { Console.WriteLine(Snackbar.IsShown); };
Snackbar.Dismissed += (s, e) => { Console.WriteLine(Snackbar.IsShown); };

Vlastnosti

Vlastnost Type Popis
Text string Textová zpráva: Povinní účastníci
Akce Action Akce, která vyvolá tlačítko akce, klikněte na tlačítko akce.
ActionButtonText string Text tlačítka akce
Záložka IView Snackbar kotva. Snackbar zobrazí se poblíž tohoto zobrazení. Když nullse Snackbar zobrazí v dolní části obrazovky.
Doba trvání TimeSpan Snackbar trvání.
VisualOptions SnackbarOptions Snackbar vizuální možnosti.

SnackbarOptions

Umožňuje SnackbarOptions přizpůsobit výchozí Snackbar styl.

Vlastnosti

Vlastnost Type Popis Default value
Mezery mezi znaky double Mezery mezi znaky zprávy 0.0d
Písmo Font Písmo zprávy Font.SystemFontOfSize(14)
TextColor Color Barva textu zprávy Colors.Black
ActionButtonFont Font Písmo tlačítka akce Font.SystemFontOfSize(14)
ActionButtonTextColor Color Barva textu tlačítka akce Colors.Black
BackgroundColor Color Barva pozadí Colors.LightGray
CornerRadius CornerRadius Poloměr rohu. new CornerRadius(4, 4, 4, 4)

Metody

metoda Popis
Zobrazit Zobrazí požadovanou .Snackbar Tím se zavře všechny aktuálně zobrazené Snackbar
Zrušit Zavřete požadovanou Snackbaržádost .

Poznámka:

Můžete zobrazit pouze 1 Snackbar najednou. Pokud metodu Show zavoláte podruhé, první Snackbar se před zobrazením sekundy Snackbar automaticky zavře.

Příklady

Příklad této funkce najdete v ukázkové aplikaci .NET MAUI Community Toolkit.

rozhraní API

Zdrojový kód Snackbar najdete v úložišti .NET MAUI Community Toolkit na GitHubu.