CKTIS / HTML
aria-expanded — разгънато или свито състояние
`aria-expanded` съобщава дали управляваното съдържание е разгънато и трябва да следва реалния интерфейс.
Версия: WAI-ARIA 1.2
Синтаксис
<button aria-expanded="false" aria-controls="panel">Details</button>Върху бутона за разгъване задай низовете true или false. Липсата означава, че елементът не декларира разгъваемост. Не добавяй свито състояние към всеки краен възел на дърво.
Постави атрибута на управляващата контрола, не само на показвания панел. Целта може да се обозначи с aria-controls. Самата промяна на състоянието не показва съдържание и не добавя кликване, клавиатура или управление на фокуса.
Примерът свързва стандартен бутон със скрит панел. Една функция обновява едновременно видимостта и състоянието, за да не се разминават. Тестът проверява видимия панел и разгъването в дървото за достъпност. Следващо активиране използва същата функция за свиване.
Примери
<!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>Резултат
expanded=true; visible=true
Резултатът потвърждава реално отваряне на панела със съответстваща семантика за достъпност.