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

CKTIS / JavaScript

Динамични области на ARIA: status, alert, aria-live и aria-atomic

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

Версия: Current web platform; runtime support varies

Синтаксис

// Live-region roles and attributes are defined by WAI-ARIA 1.2.
role="status"  (implicit aria-live="polite", aria-atomic="true")
role="alert"   (implicit aria-live="assertive", aria-atomic="true")
aria-live="off" | "polite" | "assertive"
aria-atomic="false" | "true"

// DOM update: change the text of a node in an existing live region.
messageNode.textContent = message;

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

Използвайте role="status" за информация, която не е спешна, например броя на резултатите. Ролята подразбира aria-live="polite" и aria-atomic="true". Ролята role="alert" подразбира aria-live="assertive" и aria-atomic="true". Използвайте я пестеливо, само за спешни съобщения, които не изискват отговор. Не добавяйте излишно aria-live="assertive" към предупреждението: при някои комбинации то може да бъде съобщено два пъти.

aria-live определя приоритета: polite изчаква подходяща пауза, assertive може да прекъсне текущото съобщение, а off не заявява оповестяване, когато фокусът е извън областта. Когато фокусът е в областта, промените все още могат да бъдат съобщени. aria-atomic определя обхвата, а не приоритета: true заявява цялото съдържание на областта, а false — само променените възли. Общата стойност по подразбиране е false, но и двете описани роли подразбират true.

Поставете празна област в DOM, преди да обновите съдържанието ѝ, за предпочитане още в началния HTML. Не местете фокуса в нея само за да съобщите промяната. Някои комбинации съобщават и предупреждение, вмъкнато направо с текста му, но не разчитайте на това. Тествайте поддържаните комбинации от браузър и помощна технология.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ARIA live regions</title>
</head>
<body>
  <button type="button" id="add-result">Add result</button>
  <button type="button" id="simulate-failure">Simulate connection loss</button>
  <p id="result-status" role="status"></p>
  <p id="connection-alert" role="alert"></p>

  <script>
    const statusRegion = document.getElementById('result-status');
    const alertRegion = document.getElementById('connection-alert');
    const count = document.createElement('span');
    let total = 0;

    document.getElementById('add-result').addEventListener('click', () => {
      if (total === 0) statusRegion.append('Results: ', count);
      total += 1;
      count.textContent = String(total);
    });

    document.getElementById('simulate-failure').addEventListener('click', () => {
      alertRegion.textContent = 'Connection lost. Changes cannot be saved.';
    });
  </script>
</body>
</html>

Резултат

Initially both regions are empty.
After the first activation of Add result: Results: 1
After the second activation of Add result: Results: 2
After activating Simulate connection loss: Connection lost. Changes cannot be saved.
These are visible text updates, not a screen reader transcript.

Запазете примера като HTML файл и го отворете в браузър. Активирайте „Add result“ два пъти, а след това „Simulate connection loss“. При второто активиране се променя само числото, но `status` заявява оповестяване на целия текст. Резултатът е видимият текст, а не гарантирано прочитане.

Свързани уроци

  • JavaScript · Урок 23 · Средно · Версия: 3

Източници