Accordion
Tumpukan pertanyaan atau bagian yang masing-masing membuka panelnya dengan spring. Untuk isi yang dibaca sebagian saja; jangan pernah untuk menyembunyikan hal yang dibutuhkan semua orang.
Penggunaan
Pakai saat
- Pertanyaan yang sering diajukan, ketika setiap orang hanya butuh satu atau dua jawaban.
- Detail tambahan di bawah setiap butir halaman: isi tiap jenis layanan, aturan tiap bagian ujian.
- Halaman pengaturan atau rujukan yang panjang, yang bagiannya bisa dibaca satu per satu (
data-lds-accordion="single"menjaga hanya satu yang terbuka).
Pakai yang lain saat
- Berpindah antar tampilan setara dari isi yang sama: pakai Tabs.
- Beberapa butir pertama daftar, sisanya di balik tombol: pakai Show more.
- Hierarki bertingkat folder atau halaman: pakai Tree.
- Satu langkah yang diambil asisten, beserta detailnya: pakai Tool call.
- Navigasi di dalam halaman panjang: pakai Outline.
- Isi yang wajib dibaca semua orang; tampilkan saja: pakai Prose.
Letaknya. Di kolom isi, selebar kolom itu, sering di bawah judul bagian. Putih dengan ring di atas kanvas, .acc--fill di atas panel putih. Di ponsel sama saja; seluruh baris menjadi area ketuk.
Contoh
data-lds-accordion="single", membuka satu butir menutup butir lain.Bisa, sampai akhir minggu kedua. Setelah itu, perubahan perlu persetujuan wali kelas.
Di menu Akademik, lalu Riwayat. Anda bisa mengunduhnya sebagai PDF.
Ajukan ujian susulan paling lambat tiga hari dengan surat yang menjelaskan alasannya.
<div class="acc" data-lds-accordion="single" style="max-width: 560px;"> <div class="acc__item"><button class="acc__btn" id="faq1-b" aria-expanded="true" aria-controls="faq1">Bisakah saya mengubah jadwal setelah mendaftar?<span class="ic" aria-hidden="true">expand_more</span></button><div class="acc__panel is-open" id="faq1" role="region" aria-labelledby="faq1-b"><div><p>Bisa, sampai akhir minggu kedua. Setelah itu, perubahan perlu persetujuan wali kelas.</p></div></div></div> <div class="acc__item"><button class="acc__btn" id="faq2-b" aria-expanded="false" aria-controls="faq2">Di mana saya menemukan rapor saya?<span class="ic" aria-hidden="true">expand_more</span></button><div class="acc__panel" id="faq2" role="region" aria-labelledby="faq2-b"><div><p>Di menu Akademik, lalu Riwayat. Anda bisa mengunduhnya sebagai PDF.</p></div></div></div> <div class="acc__item"><button class="acc__btn" id="faq3-b" aria-expanded="false" aria-controls="faq3">Bagaimana jika saya tidak ikut ujian?<span class="ic" aria-hidden="true">expand_more</span></button><div class="acc__panel" id="faq3" role="region" aria-labelledby="faq3-b"><div><p>Ajukan ujian susulan paling lambat tiga hari dengan surat yang menjelaskan alasannya.</p></div></div></div> </div>
.acc__title dengan .acc__sub, dan .acc__content untuk daftar dan aksi. Beberapa butir bisa terbuka bersamaan.Soal menguji kosakata, analogi, dan pemahaman bacaan.
- Setiap jawaban benar bernilai 5.
- Jawaban salah dan kosong bernilai 0.
Deret angka, aritmetika, dan soal cerita. Kalkulator tidak boleh dipakai.
<div class="acc acc--fill" style="max-width: 560px;"> <div class="acc__item"><button class="acc__btn" aria-expanded="false" aria-controls="sec1"><span class="acc__title">Bagian 1: penalaran verbal<span class="acc__sub">35 soal · 40 menit</span></span><span class="ic" aria-hidden="true">expand_more</span></button><div class="acc__panel" id="sec1" role="region"><div><div class="acc__content"><p>Soal menguji kosakata, analogi, dan pemahaman bacaan.</p><ul><li>Setiap jawaban benar bernilai 5.</li><li>Jawaban salah dan kosong bernilai 0.</li></ul><button class="btn btn--secondary btn--sm" style="align-self: flex-start;">Coba 5 contoh soal</button></div></div></div></div> <div class="acc__item"><button class="acc__btn" aria-expanded="false" aria-controls="sec2"><span class="acc__title">Bagian 2: penalaran numerik<span class="acc__sub">30 soal · 30 menit</span></span><span class="ic" aria-hidden="true">expand_more</span></button><div class="acc__panel" id="sec2" role="region"><div><div class="acc__content"><p>Deret angka, aritmetika, dan soal cerita. Kalkulator tidak boleh dipakai.</p></div></div></div></div> </div>
Anatomi
| Bagian | Fungsinya |
|---|---|
.acc | Wajib. Grupnya: putih, ring, radius besar. data-lds-accordion="single" menutup yang lain saat satu dibuka. |
.acc--fill | Isian tenang, tanpa ring. |
.acc__item | Wajib. Satu pertanyaan atau bagian; garis tipis di antara butir. |
button.acc__btn | Wajib. Baris 56 px berisi judul dan ikon expand_more yang berputar saat terbuka. aria-expanded dan aria-controls. |
.acc__title > text + .acc__sub | Judul dua baris opsional dengan baris kedua yang lebih samar. |
.acc__panel(.is-open) | Wajib. Panelnya; terbuka dengan menganimasikan baris grid. Berisi satu div. |
.acc__panel > div > p | Teks jawaban biasa. |
.acc__panel > div > .acc__content | Isi yang lebih kaya: daftar mendapat bullet dan jarak, tabel dan aksi bertumpuk dengan jarak 10 px. |
Varian dan ukuran
| Kelas atau atribut | Kapan |
|---|---|
acc | Putih dengan ring. |
acc--fill | Isian tenang, untuk panel putih. |
data-lds-accordion="single" | Satu butir terbuka sekaligus. |
Status
| Status | Caranya |
|---|---|
closed | aria-expanded="false" pada tombol, .acc__panel tanpa is-open. |
open | aria-expanded="true" dan .acc__panel.is-open; ikon berputar 180 derajat. |
hover | Tombol diberi warna --bg-tint. |
Gerak dan mikrointeraksi
- Tinggi:
.acc__panelmenganimasikangrid-template-rowsdari 0fr ke 1fr dengan--spring-smooth(--d-smooth, 560 ms), bukan tebakanmax-height, sehingga isi setinggi apa pun terbuka dengan kecepatan yang sama. - Isi: opacity dan naik 4 px. Masuk: opacity selama
--d-standarddengan--ease-enterterlambat 80 ms, naik dengan--spring-smoothterlambat 40 ms, sehingga ruangnya terbuka sebelum teks tiba. Keluar: keduanya selama--d-fastdengan--ease-exit. - Chevron berputar 180 derajat dengan
--spring-smooth. Semuanya transition, jadi klik kedua di tengah jalan membalik arah dengan mulus. - Reduced motion: perubahan linear 120 ms.
Aksesibilitas
- Kepala butir adalah
<button>asli denganaria-expandeddanaria-controlsyang menunjukidpanel. Bungkus dengan heading (h3) bila accordion menjadi kerangka halaman. - Panel memakai
role="region"danaria-labelledbyke tombolnya bila jumlahnya enam atau kurang; lepas role itu untuk daftar panjang. - Panel tertutup hanya diciutkan secara visual; tautan dan tombol di dalamnya tetap bisa difokus. Pasang
inertpada panel tertutup yang berisi kontrol (pengguna ReactAccordionItembisa menambahkannya dengan cara yang sama). - Enter dan Space membuka dan menutup (tombol bawaan). Jangan menahan tombol panah.
Lakukan dan hindari
Lakukan
- Tulis setiap judul sebagai pertanyaan atau nama bagian yang dicari orang.
- Pakai mode
singlehanya bila butirnya saling menggantikan; biarkan FAQ membuka beberapa sekaligus. - Buka butir yang menjawab pertanyaan paling umum secara default bila itu membantu.
Hindari
- Menyembunyikan informasi wajib atau aksi utama di panel tertutup.
- Menumpuk accordion di dalam accordion.
- Menganimasikan tinggi dengan
max-heightatau pengukuran lewat JS.
Perilaku dan kode
HTML biasa. init() memasang setiap .acc__btn[aria-controls]: klik membalik aria-expanded dan mengganti .is-open pada panel. data-lds-accordion="single" pada grup menutup butir lain.
React. Dari lampung-design-system/react.
import { AccordionItem } from 'lampung-design-system/react';
<div className="acc">
<AccordionItem title="Section 1: verbal reasoning" sub="35 questions · 40 minutes" defaultOpen>
<p>Questions test vocabulary, analogies and reading.</p>
</AccordionItem>
</div>