Komponen Switch
memungkinkan pengguna beralih antara dua status: dicentang
dan tidak dicentang. Gunakan tombol untuk memungkinkan pengguna melakukan salah satu
hal berikut:
- Aktifkan atau nonaktifkan setelan.
- Mengaktifkan atau menonaktifkan fitur.
- Pilih salah satu opsi.
Komponen ini memiliki dua bagian: thumb dan trek. Thumb adalah bagian tombol yang dapat ditarik, dan jalur adalah latar belakang. Pengguna dapat menarik thumb ke kiri atau kanan untuk mengubah status tombol. Mereka juga dapat mengetuk tombol untuk memeriksa dan menghapusnya.
Kompatibilitas versi
Implementasi ini mengharuskan minSDK project Anda ditetapkan ke API level 21 atau yang lebih tinggi.
Dependensi
Mengimplementasikan tombol
Contoh berikut adalah implementasi minimal composable Switch
:
Hasil
![Tombol dasar yang tidak dicentang.](https://developer.android.com/static/develop/ui/compose/images/components/switch-deactivated.png?hl=id)
![Tombol dasar yang dicentang.](https://developer.android.com/static/develop/ui/compose/images/components/switch.png?hl=id)
Membuat thumbnail kustom
Anda dapat meneruskan composable apa pun untuk parameter thumbContent
guna membuat thumbnail
kustom. Berikut adalah contoh tombol yang menggunakan ikon kustom untuk
thumb-nya:
Hasil
Tampilan yang tidak dicentang sama dengan contoh di bagian sebelumnya. Namun, jika dicentang, penerapan ini akan muncul sebagai berikut:
![Tombol yang menggunakan parameter thumbContent untuk menampilkan ikon kustom saat dicentang.](https://developer.android.com/static/develop/ui/compose/images/components/switch-icon.png?hl=id)
Menggunakan warna kustom
Gunakan parameter colors
untuk
mengubah warna tombol dan jalur tombol, dengan mempertimbangkan apakah
tombol dicentang.
Hasil
![Tombol yang menggunakan parameter warna untuk menampilkan tombol dengan warna kustom untuk ibu jari dan paku.](https://developer.android.com/static/develop/ui/compose/images/components/switch-colors.png?hl=id)
Poin utama
Parameter dasar:
checked
: Status awal tombol.onCheckedChange
: Callback yang dipanggil saat status tombol berubah.enabled
: Apakah tombol diaktifkan atau dinonaktifkan.colors
: Warna yang digunakan untuk tombol.
Parameter lanjutan
thumbContent
: Gunakan ini untuk menyesuaikan tampilan thumb saat dipilih.colors
: Gunakan ini untuk menyesuaikan warna trek dan thumbnail.
Koleksi yang berisi panduan ini
Panduan ini adalah bagian dari koleksi Panduan Cepat pilihan yang membahas sasaran pengembangan Android yang lebih luas:
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=id)