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

CKTIS / HTML

aria-atomic — представяне на цялото променено съобщение

`aria-atomic` определя дали обновяване на жива област се представя като цяло или само като променената част.

Версия: WAI-ARIA 1.2

Синтаксис

<div aria-live="polite" aria-atomic="true">Total: <span>2</span></div>

ARIA използва низовете true и false, а не булев HTML атрибут, включен чрез присъствие. В област aria-live="polite" с „Total: 2 items“ стойността true запазва контекста при промяна само на числото. Не определя спешността и сама не създава жива област.

Определящ е най-близкият изричен атрибут по веригата от предци. Изричният false спира търсенето; без приложима настройка по подразбиране се представя променената част. Някои роли имат подразбиращи се стойности: например status по подразбиране е атомарна.

Примерът променя само span и запазва цялото съобщение. Проверени са DOM и атомарното свойство в дървото за достъпност на Chromium. Това не гарантира определено изречение от всеки четец: помощните технологии могат да обединяват обновяванията. Избягвай големи области, повтарящи дълъг текст.

Примери

<!doctype html><meta charset="utf-8">
<div id="status" aria-live="polite" aria-atomic="true">Total: <span id="count">2</span> items</div>
<output id="result"></output>
<script>
document.querySelector('#count').textContent = '3';
const status = document.querySelector('#status');
document.querySelector('#result').textContent =
  'atomic=' + status.getAttribute('aria-atomic') + '; region=' + status.textContent;
</script>

Резултат

atomic=true; region=Total: 3 items

Тестът потвърждава предоставената семантика и крайното съдържание. Реалната реч изисква тест с избрания екранен четец.

Източници