Addaw, joan hasierara Egin dohaintza

Teknika ARIA WCAG 2.2

ARIA18Erroreen berri ematea alerta-leiho batekin (role="alertdialog")

Izen ofiziala W3Cn: aria-alertdialog erabiltzea erroreak identifikatzeko

Versión en castellano · Versió en català

Laburbilduz

Norbaitek datu oker bat duen formulario bat bidaltzen duenean, orriaren gainerakoa blokeatzen duen alerta-leiho batekin eman dakioke horren berri. role="alertdialog" erabilita, pantaila-irakurgailuak leihoa iragartzen du irekitzean. Fokua leihoan sartzen da, barruan geratzen da eta, leihoa ixtean, lehen zegoen lekura itzultzen da.

Zergatik da garrantzitsua

Ikusi bakarrik egiten den errore-abisu batek ez dio balio pantaila-irakurgailua erabiltzen duenari. Pertsona hori «Bidali» botoian gera daiteke, zerbaitek huts egin duela jakin gabe.

role="alertdialog" duen leiho bat iragarri egiten da irekitzean, eta fokua jasotzen du. Pertsonak badaki zer errore dagoen eta, mezuak azaltzen badu, nola zuzendu. Teklatuarekin nabigatzen duenari ere laguntzen dio, ez baita orrian galtzen.

Nola egiten da

  1. Sortu leihoa role="alertdialog" eta aria-modal="true" erabilita. <dialog> elementua ere erabil dezakezu, showModal() bidez irekita, eta role hori gehitu.
  2. Eman izen bat aria-labelledby bidez, haren izenburua adierazita, edo aria-label bidez.
  3. Idatzi bertan zein datu dagoen gaizki eta nola zuzendu: «Hitzorduaren datak gaur baino geroagokoa izan behar du».
  4. Sartu botoi bat gutxienez («Ados», adibidez), eta eraman fokua hartara leihoa irekitzean.
  5. Irekita dagoen bitartean, tabuladoreak ez du leihotik irten behar.
  6. Ixtean, itzuli fokua, ahal bada, lehen zegoen lekura.

Nola egiaztatu

  1. Eragin errorea; adibidez, formularioa gaizki idatzitako datu batekin bidalita.
  2. Egiaztatu fokua leihoko elementu batera igarotzen dela, haren botoira, adibidez.
  3. Sakatu tabuladorea hainbat aldiz. Fokuak ez du leihotik irten behar.
  4. Itxi leihoa eta egiaztatu fokua lehen zegoen lekura itzultzen dela.
  5. Pantaila-irakurgailu batekin, egiaztatu leihoaren izena eta errorea iragartzen direla, eta testuak nola zuzendu azaltzen duela.

Adibidea

Aurretiazko hitzorduaren formularioko errore bat azaltzen duen alerta-leihoa.

<div role="alertdialog" aria-modal="true"
     aria-labelledby="tit-error" aria-describedby="txt-error">
  <h2 id="tit-error">Errore bat dago formularioan</h2>
  <p id="txt-error">
    Hitzorduaren datak gaur baino geroagokoa izan behar du.
    Idatzi ee/hh/uuuu formatuan.
  </p>
  <button type="button">Ados</button>
</div>
Ikusi W3Cren testu osoa (euskarazko itzulpena)

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

Aplikagarritasuna

Accessible Rich Internet Applications (WAI-ARIA) onartzen duten teknologiak.

Deskribapena

Teknika honen helburua da pertsonei datuak sartzean errore bat gertatu dela jakinaraztea. role="alertdialog" erabiltzeak jakinarazpen bat sortzen du. Jakinarazpen horrek modala izan behar du, eta ezaugarri hauek izan behar ditu:

  • aria-label edo aria-labelledby atributuak izen irisgarri bat ematen dio alertdialog-ari.
  • alertdialog-ak gutxienez foku daitekeen elementu bat dauka, eta fokuak elementu horretara joan behar du alertdialog-a irekitzen denean.
  • Tabulazio-ordena alertdialog-aren barrura mugatuta geratzen da irekita dagoen bitartean.
  • alertdialog-a ixten denean, fokua, ahal bada, alertdialog-a ireki aurretik zuen posiziora itzultzen da.

Adibideak

Alerta-elkarrizketa-koadroa

Adibide honek erakusten du nola erabil daitekeen role="alertdialog" duen jakinarazpen bat norbaiti baliozkoa ez den informazioa sartu duela jakinarazteko.

<dialog aria-labelledby="alert-heading" id="date-alert" role="alertdialog">
  <h1 id="alert-heading">Error</h1>
  <p>Employee's Birth Date is after their hire date. Please verify the birth date and hire date.</p>
  <button command="close" commandfor="date-alert" type="button">Return to page and correct error</button>
</dialog>

Adibide funtzionala: aria-alertdialog erabiltzea erroreak identifikatzeko .

Probak

Prozedura

  1. Eragin alertdialog-a agerrarazten duen errorea.
  2. Zehaztu alertdialog-ak gutxienez foku daitekeen elementu bat daukala eta fokua elementu horretara joaten dela alertdialog-a irekitzen denean.
  3. Jatorrizkoa ez den dialog elementu bat erabiltzen bada: zehaztu tabulazio-ordena alertdialog-aren barrura mugatuta geratzen dela irekita dagoen bitartean, eta, alertdialog-a ixten denean, fokua, ahal bada, alertdialog-a ireki aurretik zuen posiziora itzultzen dela.
  4. Aztertu alertdialog aplikatu zaion elementua.
  5. Zehaztu aria-label edo aria-labelledby atributua behar bezala erabili dela alertdialog-ari izen irisgarri bat emateko.
  6. Zehaztu alertdialog-aren edukiak datuak sartzean gertatutako errorea identifikatzen duela.
  7. Zehaztu alertdialog-aren edukiak errorea nola zuzendu iradokitzen duen.

Espero diren emaitzak

  • 2., 3., 5. eta 6. egiaztapenak egiazkoak dira. 3.3.3 Erroreak zuzentzeko iradokizunak betetze-irizpiderako, 7. egiaztapena ere egiazkoa da.

Baliabideak

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