Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

aria-atomic — predstavitev celotnega spremenjenega sporočila

`aria-atomic` določa, ali naj se posodobitev živega območja predstavi v celoti ali samo kot spremenjeni del.

Različica: WAI-ARIA 1.2

Sintaksa

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

ARIA uporablja niza true in false, ne logičnega atributa HTML, ki ga vklopi prisotnost. V območju aria-live="polite" z »Total: 2 items« vrednost true ohrani kontekst, ko se spremeni le število. Ne določa nujnosti in sama ne ustvari živega območja.

Odloča najbližji izrecni atribut v verigi prednikov. Izrecni false ustavi iskanje; brez ustrezne nastavitve je privzet spremenjeni del. Nekatere vloge imajo implicitne vrednosti, na primer status je privzeto atomski.

Primer spremeni le span, celotno sporočilo pa ostane skupaj. Preverjena sta DOM in atomska lastnost v drevesu dostopnosti Chromiuma. To ne zagotavlja določene izgovorjene povedi pri vsakem bralniku: podporna tehnologija lahko združuje posodobitve. Izogni se velikim območjem, ki ponavljajo dolgo besedilo.

Primeri

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

Rezultat

atomic=true; region=Total: 3 items

Test potrdi izpostavljeno semantiko in končno vsebino. Dejanski govor zahteva preizkus z izbranim bralnikom zaslona.

Viri