共用方式為


Snackbar

Snackbar是預設出現在畫面底部的計時警示。 它會在可設定的時間持續時間之後關閉。 Snackbar 是完全可自定義的,而且可以錨定至任何 IView

Snackbar 通知使用者應用程式已執行或將執行的進程。 它會暫時出現在畫面底部。

平臺特定初始化

若要存取 Snackbar 此功能,需要下列平臺特定的設定。

不需要設定。

語法

Snackbar使用 C# 叫用 。

C#

若要顯示 Snackbar 您需要建立它,請使用靜態方法 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);

呼叫 Snackbar.Make()時,需要其 參數 string text 。 所有其他參數皆為選擇性使用。

下列螢幕快照顯示產生的零食店:

另外還有擴充方法,會將 錨定 Snackbar 至任何 VisualElement

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

警告

Snackbar 在 Windows 上無法錨定, VisualElement 且一律會顯示為預設 Windows 通知。

SnackBar 包含兩個事件:

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

它也包含 屬性 public static bool IsShown { get; }

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

屬性

屬性 類型​ 描述
Text string 簡訊。 必要
動作 Action 動作按鈕按下時要叫用的動作。
ActionButtonText string 動作按鈕文字。
錨點 IView Snackbar 錨。 Snackbar 會出現在此檢視附近。 當 為 時 nullSnackbar 會出現在畫面底部。
期間 TimeSpan Snackbar 期間。
VisualOptions SnackbarOptions Snackbar 視覺選項。

SnackbarOptions

SnackbarOptions允許自定義預設Snackbar樣式。

屬性

屬性 類型​ 描述 預設值
CharacterSpacing double 訊息字元間距。 0.0d
字型 Font 訊息字型。 Font.SystemFontOfSize(14)
TextColor Color 消息正文色彩。 Colors.Black
ActionButtonFont Font 動作按鈕字型。 Font.SystemFontOfSize(14)
ActionButtonTextColor Color 動作按鈕文字色彩。 Colors.Black
BackgroundColor Color 背景色彩。 Colors.LightGray
CornerRadius CornerRadius 圓角半徑。 new CornerRadius(4, 4, 4, 4)

方法

方法 描述
顯示 顯示所要求的 Snackbar。 這會關閉目前顯示的任何 Snackbar
關閉 關閉要求的 Snackbar

注意

您只能同時顯示 1 Snackbar 。 如果您第二次呼叫 Show 方法,則會 Snackbar 在第二次顯示第二次之前自動關閉第一 Snackbar 個方法。

範例

您可以在 .NET MAUI Community Toolkit 範例應用程式中找到這項功能的範例。

API

您可以在 .NET MAUI Community Toolkit GitHub 存放庫找到 的Snackbar原始程式碼。