Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Prístupné interakcie v JavaScripte

Prístupná interakcia spája ovládanie klávesnicou, predvídateľný fokus a stav zrozumiteľný pre asistenčné technológie. JavaScript má synchronizovať viditeľnosť s ARIA a oznamovať aktualizácie bez zbytočného presúvania fokusu.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

element.setAttribute('aria-expanded', String(expanded));
panel.hidden = !expanded;
trigger.focus();
status.textContent = message;

Prístupná interakcia umožňuje ovládať rozhranie bez myši a porozumieť jeho zmenám pomocou asistenčných technológií. Začnite natívnymi tlačidlami: poskytujú sémantiku aj aktiváciu klávesnicou. ARIA opisuje rozhranie, sama však nepridáva správanie. Špecifikácia ECMAScript opisuje jazyk a oddeľuje ho od hostiteľského prostredia; dodaný zdroj nedefinuje DOM, HTML ani ARIA.

Správa stavu ARIA a fokusu klávesnice znamená synchronizovať stav, viditeľnosť a fokus. V príklade zodpovedá aria-expanded opačnej hodnote panel.hidden a aria-controls označuje panel. Pri teste otvorenia je fokus už na tlačidle Details a zostáva na ňom; panel nie je modálne dialógové okno. Obsluha tlačidla Close details presunie fokus na Details pred skrytím panela. Pri zatvorení panela tlačidlom Details funkcia setExpanded vráti fokus na toto tlačidlo ešte pred skrytím panela, ak je fokus stále vnútri panela. Test v konzole pokrýva oba spôsoby zatvorenia vrátane aktivácie tlačidla Details bez toho, aby sa naň najprv presunul fokus. Neodstraňujte viditeľný indikátor fokusu a nepoužívajte kladné hodnoty tabindex na opravu poradia navigácie.

Oznámenia zo živých oblastí ARIA oznamujú aktualizácie bez presunutia fokusu. Príklad aktualizuje textContent v existujúcej oblasti s role="status". Táto rola implicitne zabezpečuje správanie zodpovedajúce aria-live="polite"; v kóde HTML nie je nastavený atribút aria-live. Atribút aria-atomic="true" určuje, že celý obsah oblasti sa má považovať za správu. Oblasť existuje ešte pred aktualizáciou. Nepoužívajte ju namiesto popisov ovládacích prvkov ani neoznamujte každú drobnú zmenu. Presné znenie a načasovanie oznámení závisia od prehliadača a asistenčnej technológie.

Uložte príklad ako súbor HTML a skontrolujte ovládanie klávesnicou, hodnoty atribútov a oznámenia čítačky obrazovky. Očakávaný výstup opisuje stav DOM a umiestnenie fokusu, nie to, čo čítačka obrazovky zaručene vysloví. Príklad bol spustený v izolovanom prostredí v prehliadači Chromium a výstup konzoly sa presne zhodoval s očakávaným výstupom. Používa syntax ECMAScript 2015 a rozhrania prehliadača; podporu v cieľovom prostredí treba overiť osobitne. Node 24 v repozitári nedokazuje podporu týchto rozhraní.

Prí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ýsledok

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 programovo aktivuje tlačidlo `Details`, keď je fokus na tlačidle `Close details`. Fokus by sa mal vrátiť na `Details` ešte pred skrytím panela.

Zdroje