Snackbar

Komponen snackbar berfungsi sebagai notifikasi singkat yang muncul di bagian bawah layar. Memberikan masukan tentang operasi atau tindakan tanpa mengganggu pengalaman pengguna. Snackbar hilang setelah beberapa detik. Pengguna juga dapat menutupnya dengan tindakan, seperti mengetuk tombol.

Pertimbangkan tiga kasus penggunaan ini saat Anda dapat menggunakan snackbar:

• Konfirmasi Tindakan: Setelah pengguna menghapus email atau pesan, snackbar akan muncul untuk mengonfirmasi tindakan dan menawarkan opsi "Urungkan".
• Status Jaringan: Saat aplikasi kehilangan koneksi internet, snackbar akan muncul untuk menunjukkan bahwa aplikasi sedang offline.
• Pengiriman Data: Setelah berhasil mengirimkan formulir atau memperbarui setelan, snackbar mencatat bahwa perubahan berhasil disimpan.

Contoh dasar

Untuk menerapkan snackbar, pertama-tama Anda membuat SnackbarHost yang menyertakan properti SnackbarHostState. SnackbarHostState menyediakan akses ke fungsi showSnackbar() yang dapat Anda gunakan untuk menampilkan snackbar.

Fungsi penangguhan ini memerlukan CoroutineScope seperti dengan menggunakan rememberCoroutineScope — dan dapat dipanggil sebagai respons terhadap peristiwa UI untuk menampilkan Snackbar dalam Scaffold.

val scope = rememberCoroutineScope()
val snackbarHostState = remember { SnackbarHostState() }
Scaffold(
    snackbarHost = {
        SnackbarHost(hostState = snackbarHostState)
    },
    floatingActionButton = {
        ExtendedFloatingActionButton(
            text = { Text("Show snackbar") },
            icon = { Icon(Icons.Filled.Image, contentDescription = "") },
            onClick = {
                scope.launch {
                    snackbarHostState.showSnackbar("Snackbar")
                }
            }
        )
    }
) { contentPadding ->
    // Screen content
}
MaterialLayoutSnippets.kt

Snackbar dengan tindakan

Anda dapat memberikan tindakan opsional dan menyesuaikan durasi Snackbar. Fungsi snackbarHostState.showSnackbar() menerima parameter actionLabel dan duration tambahan, serta menampilkan SnackbarResult.

val scope = rememberCoroutineScope()
val snackbarHostState = remember { SnackbarHostState() }
Scaffold(
    snackbarHost = {
        SnackbarHost(hostState = snackbarHostState)
    },
    floatingActionButton = {
        ExtendedFloatingActionButton(
            text = { Text("Show snackbar") },
            icon = { Icon(Icons.Filled.Image, contentDescription = "") },
            onClick = {
                scope.launch {
                    val result = snackbarHostState
                        .showSnackbar(
                            message = "Snackbar",
                            actionLabel = "Action",
                            // Defaults to SnackbarDuration.Short
                            duration = SnackbarDuration.Indefinite
                        )
                    when (result) {
                        SnackbarResult.ActionPerformed -> {
                            /* Handle snackbar action performed */
                        }
                        SnackbarResult.Dismissed -> {
                            /* Handle snackbar dismissed */
                        }
                    }
                }
            }
        )
    }
) { contentPadding ->
    // Screen content
}
MaterialLayoutSnippets.kt

Anda dapat memberikan Snackbar kustom dengan parameter snackbarHost. Lihat dokumen referensi API SnackbarHost untuk mengetahui informasi selengkapnya.