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
<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>
<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>
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
| Bagian | Fungsinya |
|---|---|
.toggle | Wajib. <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-group | Membungkus 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-label | Wajib pada toggle hanya ikon ("Tebal"). |
Varian dan ukuran
| Kelas atau atribut | Kapan |
|---|---|
.toggle | Sendiri: tinggi 36 px, radius 10 px. |
.toggle-group .toggle | Dalam grup: tinggi 30 px di dalam padding 3 px (total 36 px, setinggi tombol medium), radius 8 px. |
Status
| Status | Caranya |
|---|---|
aria-pressed="true" | Isian --accent-tint, warna --accent-text, ikon bergaya isi. |
hover | --bg-tint dan --text-strong saat tidak tertekan. |
:active | Mengecil ke scale(0.94) dalam 90 ms, kembali dengan --spring-snappy. |
disabled | disabled; peredupan bawaan browser berlaku, jadi jelaskan alasannya di dekatnya. |
Gerak dan mikrointeraksi
- Tekan:
scale(0.94)dengan durasi 90 ms, lepas dengan--spring-snappyselama--d-snappy. - Isian dan warna tertekan berubah selama
--d-fastdengan--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">denganaria-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, tombolrole="radio"denganaria-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-labeldan 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.