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.

Toggle

Toggle

Tombol yang tetap tertekan untuk menunjukkan sebuah mode menyala (tebal, sematkan, bisukan). Sendirian ia adalah .toggle; beberapa berada di .toggle-group, bisa saling lepas (tebal, miring, garis bawah) atau satu per satu (rata kiri, tengah, kanan).

Penggunaan

Pakai saat

  • Mode format atau tampilan yang menyala atau mati dan berlaku pada hal yang sedang dikerjakan: tebal, miring, tampilkan grid, sematkan catatan.
  • Toolbar ringkas berisi mode yang saling lepas (toggle group, beberapa bisa tertekan).
  • Pilihan satu dari dua sampai empat yang dipimpin ikon di toolbar editor (perataan), ketika segmented control terlalu lebar.

Pakai yang lain saat

  • Pengaturan yang bertahan dan berlaku di mana saja (notifikasi, dark mode): pakai Switch. Switch ada di daftar pengaturan dengan label; toggle ada di toolbar.
  • Memilih tampilan konten (daftar atau grid, minggu atau bulan): pakai Segmented control. Ia punya penanda yang bergeser dan label teks; pakai untuk tampilan.
  • Memilih filter dari sekumpulan kata: pakai Chips.
  • Aksi sekali jalan yang tidak tetap menyala: pakai Icon button.
  • Menyukai atau menyimpan dengan respons perayaan: pakai Like.

Letaknya. Di toolbar di atas hal yang diubahnya: editor, kanvas, pemutar media, header daftar. Di ponsel batasi toggle group pada empat tombol atau kurang; ia tidak turun baris.

Contoh

SendiriTekan untuk menyematkan dan melepas sematan. Ikon terisi saat menyala.
<button type="button" class="toggle" aria-pressed="true"><span class="ic" aria-hidden="true">keep</span>Disematkan</button>
<button type="button" class="toggle" aria-pressed="false" aria-label="Tampilkan grid"><span class="ic" aria-hidden="true">grid_view</span></button>
Grup saling lepasGaya teks: kombinasi apa pun bisa menyala.
<div class="toggle-group" role="group" aria-label="Gaya teks">
  <button type="button" class="toggle" aria-pressed="true" aria-label="Tebal"><span class="ic" aria-hidden="true">format_bold</span></button>
  <button type="button" class="toggle" aria-pressed="false" aria-label="Miring"><span class="ic" aria-hidden="true">format_italic</span></button>
  <button type="button" class="toggle" aria-pressed="false" aria-label="Garis bawah"><span class="ic" aria-hidden="true">format_underlined</span></button>
</div>
Satu per satuPerataan: tepat satu yang menyala. Setiap tombol adalah radio bagi teknologi bantu; aria-pressed mengikuti aria-checked karena gayanya membaca aria-pressed.
<div class="toggle-group" role="radiogroup" aria-label="Perataan">
  <button type="button" class="toggle" role="radio" aria-checked="true" aria-pressed="true" aria-label="Rata kiri"><span class="ic" aria-hidden="true">format_align_left</span></button>
  <button type="button" class="toggle" role="radio" aria-checked="false" aria-pressed="false" aria-label="Rata tengah"><span class="ic" aria-hidden="true">format_align_center</span></button>
  <button type="button" class="toggle" role="radio" aria-checked="false" aria-pressed="false" aria-label="Rata kanan"><span class="ic" aria-hidden="true">format_align_right</span></button>
</div>

Anatomi

BagianFungsinya
.toggleWajib. <button type="button"> dengan aria-pressed. Tinggi 36 px saat sendiri, 30 px di dalam grup. Ikon, teks, atau keduanya.
aria-pressed="true|false"Wajib. Menentukan tampilan: tertekan berarti --accent-tint dengan --accent-text, dan ikon berganti ke gaya isi.
.toggle-groupMembungkus dua toggle atau lebih dalam satu kotak bergaris, tinggi 36 px. role="group" (saling lepas) atau role="radiogroup" (satu per satu) dengan aria-label.
aria-labelWajib pada toggle hanya ikon ("Tebal").

Varian dan ukuran

Kelas atau atributKapan
.toggleSendiri: tinggi 36 px, radius 10 px.
.toggle-group .toggleDalam grup: tinggi 30 px di dalam padding 3 px (total 36 px, setinggi tombol medium), radius 8 px.

Status

StatusCaranya
aria-pressed="true"Isian --accent-tint, warna --accent-text, ikon bergaya isi.
hover--bg-tint dan --text-strong saat tidak tertekan.
:activeMengecil ke scale(0.94) dalam 90 ms, kembali dengan --spring-snappy.
disableddisabled; peredupan bawaan browser berlaku, jadi jelaskan alasannya di dekatnya.

Gerak dan mikrointeraksi

  • Tekan: scale(0.94) dengan durasi 90 ms, lepas dengan --spring-snappy selama --d-snappy.
  • Isian dan warna tertekan berubah selama --d-fast dengan --ease-standard; ikon langsung berganti ke font isi. Tidak ada penanda yang bergeser (itu milik segmented control).
  • Dengan reduced motion skalanya menjadi perubahan 120 ms.

Aksesibilitas

  • <button type="button"> dengan aria-pressed. Namanya tetap sama saat tertekan ("Tebal"), jangan pernah "Tebal menyala".
  • Grup saling lepas: role="group" + aria-label; setiap toggle dicapai dengan Tab.
  • Grup satu per satu: role="radiogroup" + aria-label, tombol role="radio" dengan aria-checked. Tombol panah seharusnya memindahkan pilihan; ini tidak tersedia bawaan, jadi hubungkan sendiri atau pakai segmented control yang sudah memilikinya.
  • Toggle hanya ikon butuh aria-label dan sebaiknya diberi tooltip, idealnya dengan pintasan di .kbd.

Lakukan dan hindari

Lakukan

  • Pakai toggle untuk mode di toolbar; pakai switch untuk pengaturan.
  • Pertahankan label yang sama di kedua status; tampilan tertekan yang membawa statusnya.
  • Sediakan pintasan keyboard untuk toggle format dan tampilkan di tooltip.

Hindari

  • Mengganti label menjadi "Nyala" atau "Mati".
  • Memakai toggle group sebagai tab halaman atau pengganti tampilan.
  • Mencampur toggle dan tombol aksi biasa dalam satu toggle-group.

Perilaku dan kode

HTML biasa. Tidak ada di lds.js: setel aria-pressed (dan aria-checked untuk radio) dari handler klik atau state framework Anda.