Uzun bir rehberin yardımcı açıklamalarını açılır panellerde toplamak sayfayı daha rahat taranabilir kılabilir. Ancak accordion, okuyucunun mutlaka görmesi gereken uyarıları saklamak için kullanılmamalıdır. Önce ana metni açık bırakın; ayrıntı, örnek veya sık sorulan soruları ayrı panellere taşıyın.

Bağımlılıkları aynı sürümden yükleyin

Aşağıdaki örnek Bootstrap 5.3 sınıflarını ve data-bs özniteliklerini kullanır. Bootstrap CSS ile JavaScript’in uyumlu sürümlerini bir kez yükleyin. Collapse bileşeni JavaScript gerektirir. Tema içinde zaten Bootstrap bulunuyorsa ikinci bir kopya eklemek yerine mevcut kurulumu inceleyin.

Düğmeyle hedefi eşleştirin

Her açılır alanın benzersiz id değeri olmalıdır. Düğmenin data-bs-target ve aria-controls değerleri o alanı göstermelidir. Aynı bileşeni kopyalarken kimlikleri değiştirmeyi unutmak, farklı düğmelerin aynı paneli açmasına neden olabilir.

<div class="accordion" id="rehber-panelleri">
  <div class="accordion-item">
    <h2 class="accordion-header">
      <button class="accordion-button collapsed" type="button"
        data-bs-toggle="collapse" data-bs-target="#rehber-dosya"
        aria-expanded="false" aria-controls="rehber-dosya">
        Hangi dosyayı yüklemeliyim?
      </button>
    </h2>
    <div id="rehber-dosya" class="accordion-collapse collapse"
      data-bs-parent="#rehber-panelleri">
      <div class="accordion-body">Kurulabilir tema ZIP dosyasını seçin.</div>
    </div>
  </div>
</div>

Örnekte panel kapalı başlar. Açık başlatmak isterseniz düğmenin collapsed sınıfını kaldırın, aria-expanded değerini true yapın ve hedefe show sınıfını ekleyin. Görünüm ile erişilebilirlik bilgisinin çelişmemesine dikkat edin.

Birden fazla panelin davranışını seçin

Aynı grupta tek panelin açık kalmasını istiyorsanız data-bs-parent ilişkisini kullanın. Birkaç açıklamanın birlikte açık kalması faydalıysa bu ilişkiyi kaldırabilirsiniz. Örneğin iki teslim formatını karşılaştıran kullanıcı, iki paneli aynı anda görmek isteyebilir. Bileşen seçimini içerik görevine göre yapın.

Klavye ve mobil kontrolü yapın

Tab ile düğmeye gelin, Enter veya Space ile açmayı deneyin. Odak işareti görünür kalmalı ve başlık metni küçük ekranda taşmamalıdır. Bootstrap bütün isteğe bağlı accordion klavye hareketlerini kendiliğinden sağlamaz; ok tuşu gezinmesi gibi ek davranış gerekiyorsa ayrıca uygulanıp test edilmelidir.

Son olarak JavaScript devre dışı veya yüklenememişken önemli bilginin erişilebilirliğini düşünün. Ödeme şartı veya kritik kurulum adımı yalnız kapalı paneldeyse kullanıcı bunu göremeyebilir. İçeriğin önceliğini belirlemek, çalışan bir animasyondan daha önemli bir tasarım kararıdır.

Kaynak

Resmî belge