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