Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

aria-expanded — stan rozwinięcia

`aria-expanded` informuje, czy kontrolowany obszar jest rozwinięty; musi odzwierciedlać rzeczywisty stan interfejsu.

Wersja: WAI-ARIA 1.2

Składnia

<button aria-expanded="false" aria-controls="panel">Details</button>

Na przycisku rozwijania ustaw tekstowe true lub false. Brak stanu oznacza, że element nie deklaruje możliwości rozwijania. Nie dodawaj stanu zwiniętego do każdego elementu liściowego drzewa.

Atrybut umieszczaj na kontrolce, a nie wyłącznie na pokazywanym panelu. Powiązanie celu można wskazać przez aria-controls. Samo ustawienie stanu nie pokazuje treści i nie dodaje obsługi kliknięcia, klawiatury ani fokusu.

Przykład łączy natywny przycisk z ukrytym panelem. Jedna funkcja aktualizuje widoczność i stan, dzięki czemu nie rozchodzą się po aktywacji. Test sprawdza widoczny panel oraz rozwinięcie w drzewie dostępności. Ponowna aktywacja używa tej samej funkcji do zwinięcia.

Przykłady

<!doctype html><meta charset="utf-8">
<button id="toggle" aria-expanded="false" aria-controls="panel">Details</button>
<section id="panel" hidden><h2>Course details</h2><p>Three short lessons.</p></section>
<output id="result"></output>
<script>
const button = document.querySelector('#toggle'), panel = document.querySelector('#panel');
button.addEventListener('click', () => {
  const expanded = button.getAttribute('aria-expanded') !== 'true';
  panel.hidden = !expanded;
  button.setAttribute('aria-expanded', String(expanded));
});
button.click();
document.querySelector('#result').textContent = 'expanded=' + button.getAttribute('aria-expanded') + '; visible=' + !panel.hidden;
</script>

Wynik

expanded=true; visible=true

Wynik potwierdza rzeczywiste otwarcie panelu wraz ze zgodną semantyką dostępności.

Źródła