Aracılığıyla paylaş


Snackbar

Snackbar, varsayılan olarak ekranın en altında görünen zamanlanmış bir uyarıdır. Yapılandırılabilir bir süre sonra kapatılır. Snackbar tamamen özelleştirilebilir ve herhangi bir IViewöğesine bağlanabilir.

kullanıcılara Snackbar bir uygulamanın gerçekleştirdiğini veya gerçekleştireceğini bildirir. Ekranın alt kısmında geçici olarak görünür.

Platforma özgü başlatma

İşlevlere Snackbar erişmek için aşağıdaki platforma özgü kurulum gereklidir.

Kurulum gerekmez.

Sözdizimi

Snackbar C# kullanılarak çağrılır.

C#

Görüntülemek Snackbar için statik yöntemini Makekullanarak oluşturmanız gerekir:

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);

çağrılırken Snackbar.Make()parametresi string text gereklidir. Diğer tüm parametreler isteğe bağlıdır.

Aşağıdaki ekran görüntüsünde, elde edilen Snackbar gösterilmektedir:

Ayrıca herhangi bir öğesine bağlanacak Snackbar VisualElementbir uzantı yöntemi de vardır:

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

Uyarı

Snackbar windows'a VisualElement bağlanamaz ve her zaman varsayılan Windows Bildirimi olarak görüntülenir.

SnackBar iki olay içerir:

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

Ayrıca özelliğini public static bool IsShown { get; }içerir.

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

Özellikler

Özellik Türü Açıklama
Metin string Kısa mesaj. Required
Eylem Action Eylemde çağrılacak eylem düğmesine tıklayın.
ActionButtonText string Eylem düğmesi metni.
Bağlayıcı IView Snackbar çıpa. Snackbar bu görünümün yakınında görünür. olduğunda null, Snackbar ekranın alt kısmında görüntülenir.
Süre TimeSpan Snackbar süre.
VisualOptions SnackbarOptions Snackbar görsel seçenekleri.

SnackbarOptions

varsayılan SnackbarOptions Snackbar stili özelleştirmeye izin verir.

Özellikler

Özellik Türü Açıklama Default value
CharacterSpacing double İleti karakter aralığı. 0.0d
Yazı tipi Font İleti yazı tipi. Font.SystemFontOfSize(14)
TextColor Color İleti metin rengi. Colors.Black
ActionButtonFont Font Eylem düğmesi yazı tipi. Font.SystemFontOfSize(14)
ActionButtonTextColor Color Eylem düğmesi metin rengi. Colors.Black
BackgroundColor Color Arka plan rengi. Colors.LightGray
CornerRadius CornerRadius Köşe yarıçapı. new CornerRadius(4, 4, 4, 4)

Yöntemler

Metot Açıklama
Göster İstenen Snackbaröğesini görüntüleyin. Bu, şu anda görüntülenenleri kapatacaktır Snackbar
At İstenen Snackbaröğesini kapat.

Not

Aynı anda yalnızca 1 Snackbar görüntüleyebilirsiniz. yöntemini ikinci kez çağırırsanızShow, ikincisi gösterilmeden önce Snackbar ilki Snackbar otomatik olarak kapatılır.

Örnekler

Bu özelliğin bir örneğini .NET MAUI Community Toolkit Örnek Uygulaması'nda çalışır durumda bulabilirsiniz.

API

üzerinde için Snackbar kaynak kodunu .NET MAUI Community Toolkit GitHub deposunda bulabilirsiniz.