Addaw, joan hasierara Egin dohaintza

Teknika ARIA WCAG 2.2

ARIA27Aurrerapen-barra baten aurrerapena ariaNotify bidez iragartzea

Izen ofiziala W3Cn: ariaNotify erabiltzea aurrerapen-barra baten egoera transmititzeko

Versión en castellano · Versió en català

Laburbilduz

ariaNotify JavaScripteko funtzio berri bat da, pantaila-irakurgailuari mezu bat ozenki irakurtzeko eskatzen diona. Fitxategi-igoera baten aurrerapenaren berri emateko balio du, fokua mugitu gabe. Oraindik esperimentala da; beraz, eskualde bizi baten gainean gehitutako hobekuntza gisa erabili behar da.

Zergatik da garrantzitsua

Aurrerapen-barra bat bisualki baino ez da aldatu ohi. Dokumentu bat igotzen ari den pertsona itsu batek ez daki igoerak aurrera egiten duen, gelditu den edo amaitu den.

Abisua pantaila-irakurgailura (pantailan dagoena ozenki irakurtzen duen programa) iristen bada, pertsonak lanean jarrai dezake eta emaitzaren berri izan. Hori eskatzen du egoera-mezuen irizpideak.

Nola egiten da

  1. Izan aurrerapen-barra ikusgarri bat, izena duena; adibidez, <progress> eta haren etiketa erabilita.
  2. Aurrerapena nabarmen aldatzen denean, deitu ariaNotify() funtzioari testu labur batekin; adibidez, «Igoera % 50ean».
  3. Ez iragarri ehuneko-puntu bakoitza. Eman abisua tarte jakin batzuetan eta amaitzean, pertsona ez gainkargatzeko.
  4. Ez mugitu fokua barrara edo mezura. Pertsonak zegoen lekuan jarraitu ahal izan behar du.
  5. Euskarria oraindik mugatua denez, egiaztatu lehenik funtzioa badagoela. Mantendu, gainera, role="status" duen eskualde bizi bat (ARIA25 teknika) bide nagusi gisa.

Nola egiaztatu

  1. Aurkitu orrian berez aldatzen den aurrerapen-barra bat, fitxategi bat igotzean, adibidez.
  2. Aktibatu pantaila-irakurgailu bateragarri bat eta abiarazi ekintza.
  3. Egiaztatu aurrerapena eta amaiera entzuten dituzula fokua mugitu gabe.
  4. Probatu, halaber, ariaNotify ez duen nabigatzaile batean. Eskualde biziak egoera iragartzen jarraitu behar du.

Adibidea

Igoera baten aurrerapenaren abisua, ariaNotify nabigatzaileak onartzen badu soilik erabilita.

function avisar(texto) {
  // Bide nagusia: role="status" duen eskualde bizia
  document.getElementById("estado").textContent = texto;
  // Hobekuntza gehigarria, nabigatzaileak onartzen badu
  if ("ariaNotify" in document) {
    document.ariaNotify(texto);
  }
}
avisar("Igoera % 50ean");
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko ARIA27 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.

Deskribapena

Teknika honek erakusten du nola erabili ariaNotify metodoa fitxategiak igotzeko aurrerapen-barra baten egoera software bidez laguntza-teknologiei transmititzeko.

2026ko apirilean, ariaNotify web-nabigatzaileetako eta laguntza-teknologietako ezaugarri esperimentala da oraindik.

Bateragarritasun zabalagoa izan arte, erabili ariaNotify hobekuntza progresibo gisa soilik, beste teknika fidagarriago batzuekin konbinatuta; adibidez, ARIA25: ARIAren eskualde bizi bat erabiltzea aurrerapen-barra baten egoera transmititzeko.

Adibidea

Adibide honek dokumentu baten igoeraren aurrerapena simulatzen du. Igoeraren aurrerapena bisualki jakinarazten zaio erabiltzaileari aurrerapen-barra baten bidez. Aurrerapen-barra eguneratu ahala, testu bat ere pasatzen zaio esplizituki ariaNotify metodoari, pantaila-irakurgailuek iragarpen bat egin dezaten.

Hurrengo kodea adibide funtzional gisa ere ikus daiteke.

<div class="upload-container">
  <p id="upload-progress-label">Uploading document: <strong>report.pdf</strong></p>
  <div
    aria-labelledby="upload-progress-label"
    role="progressbar"
    aria-describedby="progress-text"
    aria-valuemin="0"
    aria-valuemax="100"
    aria-valuenow="0"
    id="upload-progress"></div>
    <button id="start-upload" type="button">Start Upload</button>
document.ariaNotify("…");

Probak

Prozedura

  1. Egiaztatu orrian ba ote dagoen aurrerapen-barrarik, erabiltzaileari egoera-informazioa bisualki transmititzeko dinamikoki aldatzen dena.
  2. Pantaila-irakurgailu batekin, egiaztatu aurrerapen-barraren eguneratzeak erabiltzaileari transmititzen zaizkiola, fokua software bidez aurrerapen-barrara edo egoera-mezura mugitu gabe

Espero diren emaitzak

  • 1. eta 2. egiaztapenak egiazkoak dira.

Nola egiaztatzen dugun ADDAWn

ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.

Eskatu auditoria bat

W3Cren ARIA27 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.