Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Dostępne interakcje w JavaScript

Dostępna interakcja łączy obsługę klawiatury, przewidywalny fokus i stan zrozumiały dla technologii asystujących. JavaScript powinien synchronizować widoczność z ARIA oraz przekazywać komunikaty bez niepotrzebnego przenoszenia fokusu.

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

Składnia

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

Dostępna interakcja pozwala używać interfejsu bez myszy i rozumieć jego zmiany z pomocą technologii asystujących. Zaczynaj od natywnych przycisków: zapewniają semantykę i obsługę aktywacji z klawiatury. ARIA opisuje interfejs, ale sama nie dodaje zachowania. Specyfikacja ECMAScript opisuje język i rozdziela go od środowiska hosta; podane źródło nie definiuje DOM, HTML ani ARIA.

Zarządzanie stanem ARIA i fokusem klawiatury polega na synchronizowaniu stanu, widoczności i fokusu. W przykładzie aria-expanded odpowiada wartości przeciwnej do panel.hidden, a aria-controls wskazuje panel. W teście otwarcia fokus jest już na przycisku Details i tam pozostaje; panel nie jest oknem modalnym. Przycisk Close details przenosi fokus na Details przed ukryciem panelu. Gdy panel zamyka sam przycisk Details, funkcja setExpanded przenosi fokus na ten przycisk przed ukryciem panelu, jeśli fokus nadal znajduje się wewnątrz panelu. Test konsolowy obejmuje obie ścieżki zamknięcia, w tym aktywację Details bez uprzedniego przeniesienia na niego fokusu. Nie usuwaj widocznego wskaźnika fokusu ani nie stosuj dodatnich wartości tabindex do naprawiania kolejności nawigacji.

Komunikaty z regionów aktywnych ARIA informują o zmianach bez przenoszenia fokusu. Przykład aktualizuje textContent istniejącego regionu z role="status". Ta rola domyślnie nadaje regionowi działanie odpowiadające aria-live="polite"; w kodzie HTML nie ma atrybutu aria-live. Atrybut aria-atomic="true" wskazuje, że całą treść regionu należy traktować jako komunikat. Region istnieje przed aktualizacją. Nie zastępuj nim etykiet kontrolek ani nie ogłaszaj każdej drobnej zmiany. Dokładne wypowiedzi i moment ogłoszenia zależą od przeglądarki oraz technologii asystującej.

Zapisz przykład jako plik HTML i sprawdź obsługę klawiaturą, wartości atrybutów oraz komunikaty czytnika ekranu. Oczekiwany wynik opisuje stan DOM i położenie fokusu, a nie to, co na pewno wypowie czytnik ekranu. Przykład używa składni ECMAScript 2015 i interfejsów przeglądarki; obsługę w docelowym środowisku trzeba sprawdzić oddzielnie. Node 24 w repozytorium nie dowodzi obsługi tych interfejsów.

Przykłady

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

Wynik

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 programowo aktywuje `Details`, gdy fokus jest na `Close details`. Przed ukryciem panelu fokus powinien wrócić na `Details`.

Źródła