База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Достъпни взаимодействия в JavaScript

Достъпното взаимодействие съчетава работа с клавиатура, предвидим фокус и състояние, разбираемо за помощните технологии. JavaScript трябва да синхронизира видимостта с ARIA и да съобщава актуализациите, без да мести фокуса ненужно.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

Достъпното взаимодействие позволява използване на интерфейс без мишка и разбиране на промените в него с помощта на помощни технологии. Започнете с нативни бутони: те осигуряват семантика и активиране с клавиатура. ARIA описва интерфейса, но сама по себе си не добавя поведение. Спецификацията ECMAScript описва езика и го разграничава от хост средата; предоставеният източник не дефинира DOM, HTML или ARIA.

Управление на състоянието в ARIA и на клавиатурния фокус означава синхронизиране на състоянието, видимостта и фокуса. В примера aria-expanded съответства на обратната стойност на panel.hidden, а aria-controls обозначава panel. При теста за отваряне фокусът вече е върху бутона Details и остава там; панелът не е модален диалогов прозорец. Обработчикът на Close details премества фокуса върху Details, преди да скрие панела. Когато панелът се затваря с бутона Details и фокусът все още е вътре в панела, setExpanded връща фокуса върху Details, преди да скрие панела. Тестът в конзолата обхваща и двата начина на затваряне, включително активиране на Details, без фокусът предварително да е преместен върху бутона. Не премахвайте видимия индикатор за фокус и не използвайте положителни стойности на tabindex, за да коригирате реда на навигация.

Съобщенията от динамични области на ARIA уведомяват за промени, без да преместват фокуса. Примерът актуализира textContent в съществуваща област с role="status". Тази роля по подразбиране осигурява поведение, съответстващо на aria-live="polite"; в HTML кода не е зададен атрибут aria-live. Атрибутът aria-atomic="true" указва, че цялото съдържание на областта трябва да се третира като съобщение. Областта съществува преди актуализацията. Не я използвайте вместо етикети на контролите и не съобщавайте всяка дребна промяна. Точните думи и моментът на съобщението зависят от браузъра и помощната технология.

Запазете примера като HTML файл и проверете работата с клавиатура, стойностите на атрибутите и съобщенията на екранния четец. Очакваният резултат описва състоянието на DOM и къде е фокусът, но не гарантира какво ще произнесе екранният четец. Примерът е изпълнен в Chromium в изолирана среда и изходът в конзолата съвпадна точно с очаквания. Той използва синтаксис на ECMAScript 2015 и интерфейси на браузъра; поддръжката в целевата среда трябва да се провери отделно. Node 24 в хранилището не доказва поддръжката на тези интерфейси.

Примери

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

Резултат

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

Тестът активира програмно `Details`, докато фокусът е върху `Close details`. Фокусът трябва да се върне върху `Details`, преди панелът да бъде скрит.

Източници