Membuat tombol

Tombol memungkinkan pengguna memicu tindakan yang ditentukan. Ada lima jenis tombol:

Jenis

Tampilan

Tujuan

Diisi

Latar belakang solid dengan teks yang kontras.

Untuk tindakan utama, seperti "Kirim" dan "Simpan". Efek bayangan menekankan pentingnya tombol.

Tonal

Warna latar belakang bervariasi agar sesuai dengan permukaan.

Untuk tindakan utama atau signifikan. Tombol yang terisi memberikan bobot visual dan sesuai untuk tindakan seperti "Tambahkan ke keranjang" dan "Login".

Panas

Bayangan membuatnya terlihat jelas.

Untuk tindakan utama atau signifikan. Tingkatkan elevasi untuk membuat tombol lebih terlihat.

Disertai garis batas

Memiliki batas tanpa isi.

Untuk tindakan yang penting, tetapi bukan tindakan utama. Tombol dengan garis batas cocok dipasangkan dengan tombol lain untuk menunjukkan tindakan alternatif sekunder seperti "Batal" atau "Kembali".

Teks

Teks tanpa latar belakang atau batas.

Untuk tindakan yang kurang penting seperti link navigasi, atau tindakan sekunder seperti "Pelajari lebih lanjut" atau "Lihat detail".

Kompatibilitas versi

Implementasi ini mengharuskan minSDK project Anda ditetapkan ke API level 21 atau yang lebih tinggi.

Dependensi

Membuat tombol isi

Komponen tombol yang terisi menggunakan composable Button dasar. Secara default, warnanya diisi dengan warna solid.

Hasil

Tombol terisi dengan latar belakang ungu yang bertuliskan, 'filled'.
Gambar 1. Tombol yang terisi.

Membuat tombol tonal yang terisi

Komponen tombol tonal yang terisi menggunakan composable FilledTonalButton. Secara default, warna ini diisi dengan warna tonal.

Hasil

Tombol tonal dengan latar belakang ungu muda yang bertuliskan, 'filled'.
Gambar 2. Tombol tonal.

Membuat tombol dengan garis batas

Komponen tombol yang digarisbatasi menggunakan composable OutlinedButton. Secara default, tampilannya akan muncul dengan garis batas.

Hasil

Tombol bergaris transparan dengan batas gelap yang bertuliskan, 'Outlined'.
Gambar 3. Tombol dengan garis batas.

Membuat tombol yang ditinggikan

Komponen tombol yang ditinggikan menggunakan composable ElevatedButton. Tombol ini memiliki bayangan yang mewakili efek elevasi secara default dan muncul sebagai tombol yang digarisbatasi dengan bayangan.

Hasil

Tombol yang ditinggikan dengan latar belakang abu-abu yang bertuliskan, 'Elevated'.
Gambar 4. Tombol yang muncul.

Membuat tombol teks

Komponen tombol teks menggunakan composable TextButton. Hingga diklik, ikon hanya akan muncul sebagai teks. Secara default, bentuk ini tidak memiliki isian atau garis batas yang solid.

Hasil

Tombol teks yang bertuliskan 'Tombol Teks'
Gambar 5. Tombol teks.

Poin utama

  • onClick: Fungsi yang dipanggil saat pengguna menekan tombol.
  • enabled: Jika salah, parameter ini akan menyebabkan tombol tampak tidak tersedia dan tidak aktif.
  • colors: Instance ButtonColors yang menentukan warna yang digunakan di tombol.
  • contentPadding: Padding dalam tombol.

Koleksi yang berisi panduan ini

Panduan ini adalah bagian dari koleksi Panduan Cepat pilihan yang membahas sasaran pengembangan Android yang lebih luas:

Pelajari cara fungsi composable dapat memudahkan Anda membuat komponen UI yang menarik berdasarkan sistem desain Desain Material.

Ada pertanyaan atau masukan

Buka halaman pertanyaan umum (FAQ) dan pelajari panduan singkat atau hubungi kami dan beri tahu kami pendapat Anda.