CKTIS / JavaScript
Přístupné interakce v JavaScriptu
Přístupná interakce spojuje ovládání klávesnicí, předvídatelný fokus a stav srozumitelný pro asistivní technologie. JavaScript má synchronizovat viditelnost s ARIA a oznamovat změny bez zbytečného přesouvání fokusu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.setAttribute('aria-expanded', String(expanded));
panel.hidden = !expanded;
trigger.focus();
status.textContent = message;Přístupná interakce umožňuje ovládat rozhraní bez myši a porozumět jeho změnám pomocí asistivních technologií. Začněte nativními tlačítky: poskytují sémantiku i aktivaci klávesnicí. ARIA popisuje rozhraní, sama však nepřidává chování. Specifikace ECMAScript popisuje jazyk a odděluje jej od hostitelského prostředí; dodaný zdroj nedefinuje DOM, HTML ani ARIA.
Správa stavu ARIA a fokusu klávesnice znamená synchronizovat stav, viditelnost a fokus. V příkladu odpovídá aria-expanded opačné hodnotě panel.hidden a aria-controls označuje panel. V testu otevření je fokus už na tlačítku Details a zůstává na něm; panel není modální dialog. Obsluha tlačítka Close details přesune fokus na Details, než panel skryje. Při zavření tlačítkem Details funkce setExpanded vrátí fokus na toto tlačítko ještě před skrytím panelu, pokud je fokus stále uvnitř panelu. Test v konzoli pokrývá oba způsoby zavření včetně aktivace tlačítka Details bez předchozího přesunutí fokusu na toto tlačítko. Neodstraňujte viditelný indikátor fokusu a nepoužívejte kladné hodnoty tabindex k nápravě pořadí navigace.
Oznámení z živých oblastí ARIA sdělují aktualizace bez přesunutí fokusu. Příklad aktualizuje textContent v existující oblasti s role="status". Tato role implicitně zajišťuje chování odpovídající aria-live="polite"; v kódu HTML není atribut aria-live nastaven. Atribut aria-atomic="true" určuje, že se má celý obsah oblasti považovat za zprávu. Oblast existuje už před aktualizací. Nepoužívejte ji místo popisků ovládacích prvků ani neoznamujte každou drobnou změnu. Přesné znění a načasování oznámení závisí na prohlížeči a asistivní technologii.
Uložte příklad jako soubor HTML a ověřte ovládání klávesnicí, hodnoty atributů a oznámení čtečky obrazovky. Očekávaný výstup popisuje stav DOM a umístění fokusu, nikoli to, co čtečka obrazovky zaručeně vysloví. Příklad byl spuštěn v izolovaném prostředí v prohlížeči Chromium a výstup konzole přesně odpovídal očekávanému výstupu. Používá syntaxi ECMAScript 2015 a rozhraní prohlížeče; podporu v cílovém prostředí je nutné ověřit samostatně. Node 24 v repozitáři nedokazuje podporu těchto rozhraní.
Příklady
<!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>Výsledek
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
Test programově aktivuje tlačítko `Details`, zatímco je fokus na tlačítku `Close details`. Fokus by se měl vrátit na `Details` ještě před skrytím panelu.