Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Pristupačne interakcije u JavaScriptu

Pristupačna interakcija povezuje rad tipkovnicom, predvidljiv fokus i stanje razumljivo pomoćnim tehnologijama. JavaScript treba uskladiti vidljivost s ARIA-om i priopćavati ažuriranja bez nepotrebnog premještanja fokusa.

Verzija: 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;

Pristupačna interakcija omogućuje korištenje sučelja bez miša i razumijevanje njegovih promjena uz pomoć pomoćnih tehnologija. Započnite s izvornim gumbima: pružaju semantiku i aktivaciju tipkovnicom. ARIA opisuje sučelje, ali sama ne dodaje ponašanje. Specifikacija ECMAScript opisuje jezik i odvaja ga od njegova okruženja domaćina; navedeni izvor ne definira DOM, HTML ni ARIA.

Upravljanje stanjem ARIA i fokusom tipkovnice znači usklađivanje stanja, vidljivosti i fokusa. U primjeru aria-expanded odgovara suprotnoj vrijednosti od panel.hidden, a aria-controls označava panel. U testu otvaranja fokus je već na gumbu Details i ondje ostaje; ploča nije modalni dijaloški okvir. Funkcija za obradu događaja gumba Close details prebacuje fokus na Details prije skrivanja ploče. Kad se ploča zatvara gumbom Details, funkcija setExpanded vraća fokus na taj gumb prije skrivanja ploče ako je fokus još uvijek unutar nje. Test u konzoli obuhvaća oba načina zatvaranja, uključujući aktiviranje gumba Details bez prethodnog premještanja fokusa na njega. Nemojte uklanjati vidljivi pokazivač fokusa niti upotrebljavati pozitivne vrijednosti tabindex za ispravljanje redoslijeda navigacije.

Najave iz dinamičkih područja ARIA priopćuju ažuriranja bez premještanja fokusa. Primjer ažurira textContent u postojećem području s role="status". Ta uloga implicitno daje ponašanje koje odgovara postavci aria-live="polite"; atribut aria-live nije postavljen u HTML-u. Atribut aria-atomic="true" označava da cijeli sadržaj područja treba tretirati kao poruku. Područje postoji prije ažuriranja. Nemojte ga koristiti umjesto oznaka kontrola niti najavljivati svaku manju promjenu. Točne riječi i vrijeme objave ovise o pregledniku i pomoćnoj tehnologiji.

Spremite primjer kao HTML datoteku i provjerite upravljanje tipkovnicom, vrijednosti atributa i najave čitača zaslona. Očekivani rezultat opisuje stanje DOM-a i položaj fokusa, ali ne jamči što će čitač zaslona izgovoriti. Primjer je pokrenut u pregledniku Chromium u izoliranom okruženju, a ispis u konzoli točno se podudarao s očekivanim ispisom. Upotrebljava sintaksu ECMAScript 2015 i sučelja preglednika; podršku u ciljnom okruženju treba provjeriti zasebno. Node 24 u repozitoriju ne dokazuje podršku za ta sučelja.

Primjeri

<!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

Test programski aktivira gumb `Details` dok je fokus na gumbu `Close details`. Fokus se treba vratiti na `Details` prije skrivanja ploče.

Izvori