CKTIS / JavaScript
Dostopne interakcije v JavaScriptu
Dostopna interakcija združuje upravljanje s tipkovnico, predvidljiv fokus in stanje, razumljivo podpornim tehnologijam. JavaScript mora sinhronizirati vidnost z ARIA in sporočati posodobitve, ne da bi po nepotrebnem premikal fokus.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
element.setAttribute('aria-expanded', String(expanded));
panel.hidden = !expanded;
trigger.focus();
status.textContent = message;Dostopna interakcija omogoča uporabo vmesnika brez miške in razumevanje sprememb s pomočjo podpornih tehnologij. Začnite z izvornimi gumbi: zagotavljajo semantiko in aktivacijo s tipkovnico. ARIA opisuje vmesnik, vendar sama ne doda vedenja. Specifikacija ECMAScript opisuje jezik in ga ločuje od gostiteljskega okolja; navedeni vir ne opredeljuje DOM, HTML ali ARIA.
Upravljanje stanja ARIA in fokusa tipkovnice pomeni usklajevanje stanja, vidnosti in fokusa. V primeru aria-expanded ustreza nasprotni vrednosti panel.hidden, aria-controls pa označuje panel. Pri preizkusu odpiranja je fokus že na gumbu Details in tam tudi ostane; plošča ni modalno pogovorno okno. Obdelovalnik dogodka za Close details premakne fokus na Details, preden skrije ploščo. Ko ploščo zapre gumb Details, funkcija setExpanded vrne fokus na ta gumb, preden skrije ploščo, če je fokus še vedno znotraj nje. Preizkus v konzoli zajema oba načina zapiranja, tudi aktivacijo gumba Details brez predhodnega premika fokusa nanj. Ne odstranite vidnega kazalnika fokusa in ne uporabljajte pozitivnih vrednosti tabindex za popravljanje vrstnega reda navigacije.
Obvestila iz živih območij ARIA sporočajo posodobitve brez premikanja fokusa. Primer posodobi textContent v obstoječem območju z role="status". Ta vloga implicitno zagotavlja vedenje, ki ustreza aria-live="polite"; v kodi HTML atribut aria-live ni nastavljen. Atribut aria-atomic="true" pomeni, da je treba celotno vsebino območja obravnavati kot sporočilo. Območje obstaja že pred posodobitvijo. Ne uporabljajte ga namesto oznak kontrol in ne napovedujte vsake manjše spremembe. Natančno besedilo in čas sporočila sta odvisna od brskalnika in podporne tehnologije.
Primer shranite kot datoteko HTML ter preverite uporabo tipkovnice, vrednosti atributov in obvestila bralnika zaslona. Pričakovani rezultat opisuje stanje DOM in položaj fokusa, ne zagotavlja pa, kaj bo bralnik zaslona izgovoril. Primer je bil zagnan v brskalniku Chromium v izoliranem okolju, izpis v konzoli pa se je natančno ujemal s pričakovanim izpisom. Uporablja sintakso ECMAScript 2015 in vmesnike brskalnika; podporo v ciljnem okolju je treba preveriti posebej. Node 24 v repozitoriju ne dokazuje podpore za te vmesnike.
Primeri
<!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>Rezultat
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
Preizkus programsko aktivira gumb `Details`, ko je fokus na gumbu `Close details`. Fokus se mora vrniti na `Details`, preden se plošča skrije.