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.