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

CKTIS / JavaScript

Živa območja ARIA: status, alert, aria-live in aria-atomic

Živa območja ARIA posredujejo spremembe vsebine podporni tehnologiji brez premika fokusa. Določite prednost obvestila in količino konteksta, ki naj ga obvestilo vključi.

Različica: Current web platform; runtime support varies

Sintaksa

// 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;

Živo območje ARIA omogoča, da podporna tehnologija, na primer bralnik zaslona, sporoči spremembo vsebine brez premikanja fokusa. Te vloge in atributi so del spletne platforme, ne ECMAScripta. JavaScript posodobi DOM, na primer z textContent, če je sporočilo navadno besedilo.

Uporabite role="status" za informacije, ki niso nujne, na primer število rezultatov. Vloga implicitno določa aria-live="polite" in aria-atomic="true". Vloga role="alert" implicitno določa aria-live="assertive" in aria-atomic="true". Uporabljajte jo varčno, le za nujna sporočila, ki ne zahtevajo odziva. Opozorilu ne dodajajte odvečnega aria-live="assertive": pri nekaterih kombinacijah se lahko sporočilo predvaja dvakrat.

aria-live določa prednost: polite počaka na primeren premor, assertive lahko prekine trenutno obvestilo, off pa ne zahteva obveščanja, kadar je fokus zunaj območja. Če je fokus v območju, se spremembe še vedno lahko sporočijo. aria-atomic določa obseg, ne prednosti: true zahteva celotno vsebino območja, false pa le spremenjena vozlišča. Splošna privzeta vrednost je false, vendar obe navedeni vlogi implicitno določata true.

Prazno območje vstavite v DOM pred posodobitvijo vsebine, po možnosti že v začetnem HTML. Fokusa ne premikajte vanj samo zato, da bi se sporočila sprememba. Nekatere kombinacije sporočijo tudi opozorilo, ki je že ob vstavitvi vsebovalo besedilo, vendar se na to ne zanašajte. Preizkusite podprte kombinacije brskalnika in podporne tehnologije.

Primeri

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

Rezultat

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.

Primer shranite kot datoteko HTML in jo odprite v brskalniku. Dvakrat aktivirajte »Add result«, nato »Simulate connection loss«. Drugič se spremeni samo število, vendar `status` zahteva celotno sporočilo. Izhod je vidno besedilo, ne zagotovljen govor.

Povezane lekcije

  • JavaScript · Lekcija 23 · Srednja · Različica: 3

Viri