Proyek komunitas. Ini bukan situs resmi pemerintah.

Dikelola sukarelawan. Lampung Design System dibangun oleh komunitas open source. Tidak ada instansi pemerintah yang mengelola atau mendukungnya secara resmi.

Layanan resmi memakai go.id. Situs pemerintah Indonesia berakhiran .go.id. Jangan masukkan NIK di situs yang Anda ragukan.

Button

Button

Kontrol yang ditekan untuk menjalankan sesuatu: simpan, kirim, mulai, hapus. Satu tombol utama per tampilan; labelnya menyebut hasilnya.

Penggunaan

Pakai saat

  • Sebuah aksi terjadi di halaman atau formulir ini: kirim, simpan, mulai tugas, buka dialog.
  • Anda butuh status memuat yang menjaga lebar tombol selama aksi berjalan (.is-loading dengan btn__label dan btn__spin).

Pakai yang lain saat

  • Pindah ke halaman lain tanpa efek samping: pakai Link. Tautan diumumkan sebagai navigasi dan bisa dibuka di tab baru dengan klik tengah.
  • Kontrol hanya menampilkan ikon: pakai Icon button.
  • Menyalakan atau mematikan pengaturan yang langsung berlaku: pakai Switch.
  • Memilih satu tampilan dari konten yang sama: pakai Segmented control.
  • Konfirmasi yang mahal tetapi tidak berbahaya (kirim ujian, kirim pembayaran): pakai Hold to confirm.

Letaknya. Di ujung hal yang ditindaklanjuti: di bawah formulir (form__actions), di bagian bawah dialog (dialog__actions), di footer kartu, atau di bilah lengket pada ponsel. Tombol utama ada di kanan pada layar lebar dan di atas (lebar penuh) pada ponsel.

Contoh

VarianPrimary sekali per tampilan; secondary untuk alternatifnya; tinted untuk aksi positif yang tenang; plain untuk aksi sebaris dan tersier; danger hanya di dalam konfirmasi.
<div class="docs-row">
  <button class="btn btn--primary">Simpan perubahan</button>
  <button class="btn btn--secondary">Pratinjau</button>
  <button class="btn btn--tinted">Tambah catatan</button>
  <button class="btn btn--gray">Gandakan</button>
  <button class="btn btn--plain">Lewati dulu</button>
  <button class="btn btn--danger-tinted">Keluarkan anggota</button>
</div>
Ukuran dan ikon52 untuk satu ajakan utama di halaman depan, 44 sebagai bawaan, 36 di toolbar dan baris padat, 28 di dalam baris dan chip. Ukuran kecil tetap punya area sentuh 44 px lewat ruang di sekitarnya.
<div class="docs-row">
  <button class="btn btn--primary btn--lg"><span class="ic" aria-hidden="true">play_arrow</span>Mulai permohonan</button>
  <button class="btn btn--secondary"><span class="ic" aria-hidden="true">add</span>Tambah layanan</button>
  <button class="btn btn--secondary btn--md"><span class="ic" aria-hidden="true">download</span>Ekspor</button>
  <button class="btn btn--plain btn--sm">Ubah</button>
</div>
Memuat tanpa lompatanLabel memudar, spinner membesar masuk, lebar tetap. Coba tekan.
<button class="btn btn--primary is-loading" aria-busy="true">
  <span class="btn__label">Kirim permohonan</span>
  <span class="btn__spin" aria-hidden="true"><span class="spinner"><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i></span></span>
</button>
NonaktifLebih baik tombol tetap aktif dan menjelaskan apa yang kurang saat ditekan. Nonaktifkan hanya jika alasannya terlihat di sampingnya.
Pilih jenis masalahnya untuk mengirim laporan.
<div class="docs-col" style="max-width: 360px;">
  <button class="btn btn--primary" disabled>Kirim laporan</button>
  <span class="field__help">Pilih jenis masalahnya untuk mengirim laporan.</span>
</div>

Anatomi

BagianFungsinya
.btnWajib. <button> (atau <a> bergaya tombol saat berpindah halaman). Tinggi bawaan 44 px.
.btn--primary|secondary|…Wajib. Satu kelas varian; mengatur warna dan tampilan.
.icIkon opsional di depan label, 19 px.
.btn__labelMembungkus teks saat tombol bisa memuat, sehingga teks bisa memudar tanpa mengubah lebar.
.btn__spinSpinner yang tampil selama .is-loading aktif. Berisi .spinner dengan delapan <i>.

Varian dan ukuran

Kelas atau atributKapan
btn--primaryAksi utama tampilan. Tepat satu.
btn--secondaryAlternatif di samping tombol utama (Batal, Pratinjau, Kembali).
btn--tintedAksi positif yang tenang dan tidak boleh bersaing dengan tombol utama.
btn--grayAksi utilitas netral di toolbar.
btn--plainAksi sebaris dan tersier; hanya teks, warna aksen.
btn--dangerHanya untuk tombol konfirmasi di dalam alert dialog yang merusak.
btn--danger-tintedAksi merusak yang masih meminta konfirmasi sesudahnya.
btn--lg / btn--md / btn--sm52 / 36 / 28 px. Bawaannya 44.
btn--blockLebar penuh; bawaan untuk tombol utama di tata letak ponsel dan sheet.

Status

StatusCaranya
hoverOtomatis; hanya di perangkat yang bisa hover.
:activeMengecil ke 97 % dalam 90 ms dan memantul kembali saat dilepas.
.is-loading + aria-busyLabel keluar, spinner masuk, lebar tetap; klik diabaikan. setLoading(btn, true) di HTML biasa.
disabled / aria-disabledOpasitas 38 %, tanpa efek, tidak bisa diklik.
.is-doneLabel naik masuk sekali setelah berhasil (pasangkan dengan toast atau text morph).

Gerak dan mikrointeraksi

  • Tekan: transform: scale(0.97) pada :active dalam 90 ms, kembali dengan --spring-snappy. Umpan balik dimulai saat pointer turun, bukan saat dilepas.
  • Memuat: label keluar dengan blur 4 px dalam --d-fast; spinner membesar dari 0.6 dengan --spring-snappy. Keduanya transisi, jadi mematikan status memuat di tengah jalan berbalik dengan halus.
  • Di bawah 560 px, label panjang turun ke dua baris alih-alih mendorong tata letak ke samping (--sm tetap satu baris).
  • Untuk "Tersimpan" setelah "Simpan", ganti teksnya dengan text morph alih-alih menukar tombol.

Aksesibilitas

  • Pakai <button type="button"> untuk aksi dan <button type="submit"> di formulir; pakai <a href> hanya untuk berpindah halaman.
  • Tombol hanya ikon adalah icon button dengan aria-label.
  • Selama memuat, setel aria-busy="true"; umumkan hasilnya dengan toast atau teks sebaris.
  • Focus ring berasal dari sistem (:focus-visible); jangan pernah menghapusnya.

Lakukan dan hindari

Lakukan

  • Sebut hasilnya: "Simpan perubahan", "Kirim laporan", "Mulai permohonan".
  • Pertahankan satu tombol utama per tampilan; turunkan sisanya ke secondary, tinted, atau plain.
  • Buat tombol utama selebar layar di tata letak ponsel (btn--block).

Hindari

  • Menulis "Submit", "OK", "Klik di sini", atau "Lanjut" jika ada kata kerja yang lebih spesifik.
  • Mengubah gaya tombol dengan kelas sendiri (pil membulat, gradien, bayangan). Pilih varian.
  • Memakai btn--danger di luar konfirmasi, atau dua tombol utama berdampingan.

Perilaku dan kode

HTML biasa. Opsional. setLoading(button, true|false) menyalakan atau mematikan status memuat dan aria-busy.

React. Dari lampung-design-system/react.

import { ButtonContent } from 'lampung-design-system/react';

<button className={`btn btn--primary${saving ? ' is-loading' : ''}`} aria-busy={saving} onClick={save}>
  <ButtonContent loading={saving}>Simpan perubahan</ButtonContent>
</button>