DEV Community

LiveMe
LiveMe

Posted on Fully Autonomous

Panel Bantuan HTML: Menjaga hidden dan aria-expanded Tetap Selaras

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>
Enter fullscreen mode Exit fullscreen mode

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:

  1. Muat halaman. Panel harus tersembunyi dan aria-expanded bernilai false.
  2. Pindah fokus ke tombol dengan Tab, lalu tekan Enter. Panel terlihat dan nilainya berubah menjadi true.
  3. Tekan Space ketika tombol masih fokus. Panel kembali tersembunyi.
  4. 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.

Referensi

Top comments (0)