CKTIS / JavaScript
Достъпни взаимодействия в JavaScript
Достъпното взаимодействие съчетава работа с клавиатура, предвидим фокус и състояние, разбираемо за помощните технологии. JavaScript трябва да синхронизира видимостта с ARIA и да съобщава актуализациите, без да мести фокуса ненужно.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
element.setAttribute('aria-expanded', String(expanded));
panel.hidden = !expanded;
trigger.focus();
status.textContent = message;Достъпното взаимодействие позволява използване на интерфейс без мишка и разбиране на промените в него с помощта на помощни технологии. Започнете с нативни бутони: те осигуряват семантика и активиране с клавиатура. ARIA описва интерфейса, но сама по себе си не добавя поведение. Спецификацията ECMAScript описва езика и го разграничава от хост средата; предоставеният източник не дефинира DOM, HTML или ARIA.
Управление на състоянието в ARIA и на клавиатурния фокус означава синхронизиране на състоянието, видимостта и фокуса. В примера aria-expanded съответства на обратната стойност на panel.hidden, а aria-controls обозначава panel. При теста за отваряне фокусът вече е върху бутона Details и остава там; панелът не е модален диалогов прозорец. Обработчикът на Close details премества фокуса върху Details, преди да скрие панела. Когато панелът се затваря с бутона Details и фокусът все още е вътре в панела, setExpanded връща фокуса върху Details, преди да скрие панела. Тестът в конзолата обхваща и двата начина на затваряне, включително активиране на Details, без фокусът предварително да е преместен върху бутона. Не премахвайте видимия индикатор за фокус и не използвайте положителни стойности на tabindex, за да коригирате реда на навигация.
Съобщенията от динамични области на ARIA уведомяват за промени, без да преместват фокуса. Примерът актуализира textContent в съществуваща област с role="status". Тази роля по подразбиране осигурява поведение, съответстващо на aria-live="polite"; в HTML кода не е зададен атрибут aria-live. Атрибутът aria-atomic="true" указва, че цялото съдържание на областта трябва да се третира като съобщение. Областта съществува преди актуализацията. Не я използвайте вместо етикети на контролите и не съобщавайте всяка дребна промяна. Точните думи и моментът на съобщението зависят от браузъра и помощната технология.
Запазете примера като HTML файл и проверете работата с клавиатура, стойностите на атрибутите и съобщенията на екранния четец. Очакваният резултат описва състоянието на DOM и къде е фокусът, но не гарантира какво ще произнесе екранният четец. Примерът е изпълнен в Chromium в изолирана среда и изходът в конзолата съвпадна точно с очаквания. Той използва синтаксис на ECMAScript 2015 и интерфейси на браузъра; поддръжката в целевата среда трябва да се провери отделно. Node 24 в хранилището не доказва поддръжката на тези интерфейси.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Accessible disclosure</title>
</head>
<body>
<button id="toggle" type="button" aria-expanded="false" aria-controls="panel">Details</button>
<section id="panel" aria-label="Details" hidden>
<p>Additional information.</p>
<button id="close" type="button">Close details</button>
</section>
<p id="status" role="status" aria-atomic="true"></p>
<script>
const toggle = document.getElementById('toggle');
const panel = document.getElementById('panel');
const closeButton = document.getElementById('close');
const statusMessage = document.getElementById('status');
function setExpanded(expanded) {
if (!expanded && panel.contains(document.activeElement)) {
toggle.focus();
}
panel.hidden = !expanded;
toggle.setAttribute('aria-expanded', String(expanded));
statusMessage.textContent = expanded ? 'Details opened.' : 'Details closed.';
}
toggle.addEventListener('click', () => setExpanded(panel.hidden));
closeButton.addEventListener('click', () => {
toggle.focus();
setExpanded(false);
});
function report(step) {
console.log(`${step}: hidden=${panel.hidden}; aria-expanded=${toggle.getAttribute('aria-expanded')}; status=${JSON.stringify(statusMessage.textContent)}`);
}
report('Initial');
toggle.focus();
toggle.click();
report('Open');
console.log('Open kept focus on Details: ' + (document.activeElement === toggle));
// Test closing when activation does not first focus the close button.
toggle.blur();
console.log('Focus inside panel before close: ' + panel.contains(document.activeElement));
closeButton.click();
report('Close');
console.log('Focus returned to Details: ' + (document.activeElement === toggle));
// Test closing with Details while focus remains inside the panel.
toggle.click();
closeButton.focus();
console.log('Focus inside panel before closing with Details: ' + panel.contains(document.activeElement));
toggle.click();
report('Close with Details');
console.log('Focus returned to Details: ' + (document.activeElement === toggle));
</script>
</body>
</html>Резултат
Initial: hidden=true; aria-expanded=false; status="" Open: hidden=false; aria-expanded=true; status="Details opened." Open kept focus on Details: true Focus inside panel before close: false Close: hidden=true; aria-expanded=false; status="Details closed." Focus returned to Details: true Focus inside panel before closing with Details: true Close with Details: hidden=true; aria-expanded=false; status="Details closed." Focus returned to Details: true
Тестът активира програмно `Details`, докато фокусът е върху `Close details`. Фокусът трябва да се върне върху `Details`, преди панелът да бъде скрит.