Panel bantuan kecil tidak membutuhkan framework. Contoh ini memakai tombol HTML dan satu panel. Tujuannya: status visual dan status yang dibaca teknologi bantu berubah bersamaan.
<button type="button" id="help-toggle" aria-expanded="false" aria-controls="help-panel"> Bantuan </button> <section id="help-panel" hidden> <h2>Petunjuk singkat</h2> <p>Pilih topik sebelum mengirim pertanyaan.</p> </section> <script> const toggle = document.querySelector('#help-toggle'); const panel = document.querySelector('#help-panel'); toggle.addEventListener('click', () => { const nextOpen = toggle.getAttribute('aria-expanded') !== 'true'; toggle.setAttribute('aria-expanded', String(nextOpen)); panel.hidden = !nextOpen; }); </script> Mengapa memakai tombol?
button sudah memiliki perilaku aktivasi bawaan. Tidak perlu membuat div seolah-olah menjadi tombol dengan menambahkan penanganan tombol keyboard sendiri. type="button" juga mencegah kontrol ini menjadi tombol submit ketika contoh dipindahkan ke dalam formulir.
aria-controls menunjuk ID panel, sedangkan aria-expanded menyatakan status buka atau tutup. Atribut ARIA tidak menjalankan perubahan tampilan secara otomatis. JavaScript tetap perlu memperbarui hidden; jika salah satu tertinggal, status yang diumumkan dapat berbeda dari tampilan.
Periksa transisinya, bukan hanya keadaan awal
Coba urutan berikut pada halaman uji:
- Muat halaman. Panel harus tersembunyi dan
aria-expandedbernilaifalse. - Pindah fokus ke tombol dengan Tab, lalu tekan Enter. Panel terlihat dan nilainya berubah menjadi
true. - Tekan Space ketika tombol masih fokus. Panel kembali tersembunyi.
- Klik tombol beberapa kali. Setiap perubahan harus membalik kedua status, bukan hanya salah satunya.
Fokus tetap berada pada tombol karena contoh ini menampilkan petunjuk singkat, bukan dialog. Jangan menambahkan focus trap untuk pola sesederhana ini. Jika isi panel kelak berisi kontrol yang bisa difokuskan, periksa juga bahwa urutan Tab setelah panel dibuka tetap masuk akal.
Contoh ini tidak menyimpan status ketika halaman dimuat ulang dan tidak mengelola beberapa panel sekaligus. Untuk memperluasnya, berikan pasangan ID yang unik pada setiap tombol dan panel; hindari memakai satu ID untuk beberapa elemen.

