Addaw, joan hasierara Egin dohaintza

Teknika ARIA WCAG 2.2

ARIA25Fitxategi-igoera baten aurrerapena eskualde bizi batekin iragartzea

Izen ofiziala W3Cn: ARIAren eskualde bizi bat erabiltzea aurrerapen-barra baten egoera transmititzeko

Versión en castellano · Versió en català

Laburbilduz

Fitxategi bat igotzen den bitartean, barra batek erakusten du zenbat falta den. Pantaila-irakurgailua erabiltzen duena ez da aurrerapen horretaz ohartzen, iragartzen ez bazaio. Irtenbidea da aurrerapena eskualde bizi (aria-live) baten barruko testu batean errepikatzea; irakurgailuak testu hori irakurtzen du fokua mugitu gabe.

Zergatik da garrantzitsua

Eskaera baten PDFa igotzean, pertsona itsu batek ez du ikusten barra aurrera egiten. Ez daki igoera ondo doan, gelditu den edo amaitu den.

role="progressbar" duen barra batek bere balioa gordetzen du, baina pantaila-irakurgailuek ez dute abisurik ematen aldatzen denean. Egoera-mezu bat behar da eskualde bizi batean (aldaketak automatikoki irakurtzen zaizkion eremua).

Nola egiten da

  1. Erakutsi aurrerapena <progress> bidez edo role="progressbar" eta bere balioak (aria-valuenow, aria-valuemin, aria-valuemax) dituen elementu baten bidez.
  2. Gehitu, kargatzen denetik, aria-live="polite" edo role="status" duen edukiontzi bat. Begi-bistatik ezkuta dezakezu sr-only bezalako klase batekin.
  3. Idatzi bertan aurrerapena JavaScript bidez: «Igoera % 50ean».
  4. Ez eguneratu une oro. Egin ehuneko jakin batzuetan (adibidez, % 25 behin), ez gainkargatzeko.
  5. Amaitzean, iragarri emaitza: «Fitxategia behar bezala igo da».
  6. Ez mugitu fokua barrara edo mezura.

Nola egiaztatu

  1. Bilatu orrian berez aldatzen diren aurrerapen-barrak, fitxategiak igotzekoak, adibidez.
  2. Aktibatu pantaila-irakurgailu bat eta hasi igoera bat.
  3. Egiaztatu aurrerapenak eta amaiera iragartzen direla fokua mugitu gabe.
  4. Kodean, egiaztatu aurrerapenaren testua aria-live edo role="status" duen edukiontzi batean dagoela kargatzen denetik.

Adibidea

Igoera-barra, pantaila-irakurgailuak aldatzean iragartzen duen abisu ezkutu batekin.

<label for="subida">Igoeraren aurrerapena</label>
<progress id="subida" max="100" value="50">% 50</progress>
<p id="aviso-subida" class="sr-only" aria-live="polite">Igoera % 50ean</p>

<script>
  // % 25 behin, eguneratu abisua:
  document.getElementById('aviso-subida').textContent = 'Igoera % 75ean';
</script>
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko ARIA25 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 ARIAren eskualde bizi (live region) bat fitxategiak igotzeko aurrerapen-barra baten egoera software bidez laguntza-teknologiei transmititzeko.

Adibidea

Adibide honek dokumentu baten igoeraren aurrerapena simulatzen du. Igoeraren aurrerapena bisualki jakinarazten zaio erabiltzaileari aurrerapen-barra baten bidez. Aurrerapen-barra eguneratu ahala, bisualki ezkutatutako edukiontzi bateko testu bat ere eguneratzen da. Edukiontzi horrek aria-live="polite" atributua du. Atributu horrek pantaila-irakurgailuei adierazten die elementuaren edukian egindako eguneratzeak iragartzeko.

Hurrengo adibideak role="progressbar" atributua duen elementu bat erabiltzen du. progressbar osagaiaren aria-valuemin, aria-valuemax eta aria-valuenow balioek igoeraren aurrerapena software bidez jakinarazten dute, baina, progressbar funtzioa eskualde bizi bat ez denez, pantaila-irakurgailuek ez dituzte balio horien eguneratzeak iragarriko aldatzen direnean. ARIAren aurrerapen-barra bat erabiltzea ez da benetan garrantzitsuena teknika honetan: garrantzitsua da aurrerapena egoera-mezu baten bidez transmititzea.

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>
    <div aria-live="polite" class="visually-hidden" id="progress-text">0% complete</div>
</div>

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 ARIA25 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.