Bagikan melalui


Snackbar

Snackbar adalah pemberitahuan berwakli yang muncul di bagian bawah layar secara default. Ini diberhentikan setelah durasi waktu yang dapat dikonfigurasi. Snackbar sepenuhnya dapat disesuaikan dan dapat berlabuh ke apa pun IView.

Menginformasikan Snackbar kepada pengguna tentang proses yang telah dilakukan atau akan dilakukan aplikasi. Muncul sementara, menuju bagian bawah layar.

Inisialisasi khusus platform

Untuk mengakses Snackbar fungsionalitas, diperlukan penyiapan khusus platform berikut.

Tidak diperlukan penyiapan lain.

Sintaks

Snackbar dipanggil menggunakan C#.

C#

Untuk menampilkan Snackbar , Anda perlu membuatnya, menggunakan metode Makestatis :

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

Saat memanggil Snackbar.Make(), parameternya string text diperlukan. Semua parameter bersifat opsional.

Cuplikan layar berikut menunjukkan Snackbar yang dihasilkan:

Ada juga metode ekstensi, yang akan menjangkar ke Snackbar :VisualElement

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

Peringatan

Snackbar pada Windows tidak dapat berlabuh ke VisualElement dan selalu ditampilkan sebagai Pemberitahuan Windows default.

SnackBar berisi dua peristiwa:

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

Ini juga berisi properti public static bool IsShown { get; }.

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

Properti

Properti Tipe Deskripsi
SMS string SMS. Diperlukan
Perbuatan Action Tindakan yang akan dipanggil pada klik tombol tindakan.
ActionButtonText string Teks tombol tindakan.
Jangkar IView Snackbar jangkar. Snackbar muncul di dekat tampilan ini. Ketika null, Snackbar akan muncul di bagian bawah layar.
Durasi TimeSpan Snackbar durasi.
VisualOptions SnackbarOptions Snackbar opsi visual.

SnackbarOptions

memungkinkan SnackbarOptions kustomisasi gaya default Snackbar .

Properti

Properti Tipe Deskripsi Nilai default
CharacterSpacing double Penspasian karakter pesan. 0.0d
Font Font Font pesan. Font.SystemFontOfSize(14)
Warna Teks Color Warna teks pesan. Colors.Black
ActionButtonFont Font Font tombol tindakan. Font.SystemFontOfSize(14)
ActionButtonTextColor Color Warna teks tombol tindakan. Colors.Black
BackgroundColor Color Warna latar belakang. Colors.LightGray
CornerRadius CornerRadius Radius sudut. new CornerRadius(4, 4, 4, 4)

Metode

Metode Deskripsi
tampilkan Tampilkan yang diminta Snackbar. Ini akan mengalihkan semua yang saat ini ditampilkan Snackbar
Tutup Tutup yang diminta Snackbar.

Catatan

Anda hanya dapat menampilkan 1 Snackbar secara bersamaan. Jika Anda memanggil metode untuk kedua kalinya Show , metode pertama Snackbar akan secara otomatis diberhentikan sebelum yang kedua Snackbar ditampilkan.

Contoh

Anda dapat menemukan contoh fitur ini dalam tindakan di Aplikasi Sampel Toolkit Komunitas .NET MAUI.

API

Anda dapat menemukan kode sumber untuk Snackbar lebih pada repositori GitHub .NET MAUI Community Toolkit.