KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

aria-atomic — de hele gewijzigde melding presenteren

`aria-atomic` bepaalt of een update van een live-regio als geheel of alleen als het gewijzigde deel wordt gepresenteerd.

Versie: WAI-ARIA 1.2

Syntax

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

ARIA gebruikt de tekenreeksen true en false, geen HTML-boolean die door aanwezigheid aanstaat. In aria-live="polite" met “Total: 2 items” bewaart true de context wanneer alleen het getal verandert. Het bepaalt geen urgentie en maakt zelf geen live-regio.

Het dichtstbijzijnde expliciete attribuut in de voorouderketen telt. Expliciet false beëindigt het zoeken; zonder passende instelling is alleen het gewijzigde deel de standaard. Sommige rollen leveren impliciete waarden: status is standaard atomair.

Het voorbeeld verandert alleen de span en bewaart de volledige melding. DOM en atomaire eigenschap in Chromium’s toegankelijkheidsboom zijn gecontroleerd. Dat garandeert geen bepaalde zin van iedere schermlezer, die updates kan samenvoegen. Vermijd grote regio’s die lange teksten herhalen.

Voorbeelden

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

Resultaat

atomic=true; region=Total: 3 items

De test controleert blootgestelde semantiek en eindinhoud. Werkelijke spraak vereist een test met de gekozen schermlezer.

Bronnen