Addaw, joan hasierara Egin dohaintza

Teknika HTML WCAG 2.2

H30Nora daramaten esaten duten esteka-testuak idaztea

Izen ofiziala W3Cn: Aingura-elementuetan estekaren helburua deskribatzen duen esteka-testua ematea

Versión en castellano · Versió en català

Laburbilduz

Esteka bakoitzaren testuak, hau da, a elementuaren barruan dagoenak, nora daraman edo zer egiten duen esan behar du. Estekak irudi bat badu, haren testu alternatiboa estekaren testuaren zati gisa hartzen da. Fitxategi-bide batek edo irudi-izen batek ez diote ezer esaten esteka entzuten duenari.

Zergatik da garrantzitsua

Pantaila-irakurgailua erabiltzen duten pertsonek estekaz esteka jauzi egin ohi dute, edo esteka guztien zerrenda eskatzen dute. Haien testua baino ez dute entzuten.

Testua «/docs/of-2027.pdf» edo «icono-pdf.svg» bada, ez dakite zer dokumentu irekiko duten. Gauza bera gertatzen da alt gabeko irudi bat besterik ez duen esteka batekin. Testu argi batek azkar irakurtzen duenari edo ulermen-zailtasunak dituenari ere laguntzen dio.

Nola egiten da

  1. Idatzi esteka-testu gisa helmugaren izena: «2027ko zerga-ordenantzak», ez helbidea edo fitxategiaren izena.
  2. Esteka irudi bat besterik ez bada, jarri haren alt atributuan helmuga edo ekintza, ez ikusten dena: «Hasiera», ez «etxea».
  3. Estekak testua eta irudia baditu, erabili alt="" testua nahikoa denean. Irudiak zerbait gehitzen badu, formatua adibidez, jarri alt atributuan: «(PDF)».
  4. Saihestu «Informazio gehiago» bezalako esteka generikoak. Erabiltzen badituzu, dauden esaldiak edo zerrenda-elementuak argitu behar du helmuga.

Adibide praktikoa

Oso kasu ohikoa da egoitza elektronikoetan eta udal-webguneetan. Dokumentu-zerrendetan, estekaren testua fitxategiaren bidea da. Eta PDF ikonoak irudiaren izena du alternatiba gisa.

Horrela ez: Fitxategi-bidea testu gisa duen esteka

Estekaren testua fitxategiaren bidea da («/docs/of-2027.pdf»). Ikonoak alt="icono-pdf.svg" du. Pantaila-irakurgailuak honelako zerbait iragartzen du: «esteka, barra docs barra of marratxo 2027 puntu pdf, icono marratxo pdf puntu svg». Ez du esaten zer dokumentu irekiko den.

Adibide okerraren pantaila-argazkia: Fitxategi-bidea testu gisa duen esteka
Honela ikusten da adibide okerra.

Erakustaldiak nahita dauka azaltzen den irisgarritasun-akatsa.

Ikusi adibide okerraren kodea
<style>
  .docs { list-style: none; padding: 0; }
  .docs li { margin: 8px 0; }
  .docs a { color: #412c56; }
  .docs img { vertical-align: middle; margin-left: 6px; }
</style>
<h2>Udal-araudia</h2>
<ul class="docs">
  <li><a href="#">/docs/of-2027.pdf
    <img src="data:image/svg+xml,…" alt="icono-pdf.svg" width="20" height="20"></a></li>
  <li><a href="#">/docs/tasas-agua-2027.pdf
    <img src="data:image/svg+xml,…" alt="icono-pdf.svg" width="20" height="20"></a></li>
</ul>

Horrela bai: Esteka-testu argia eta alt erabilgarria

Orain, estekaren testua dokumentuaren izena da. Ikonoak alt="(PDF)" du, eta formatua gehitzen du. Esteka honela iragartzen da: «2027ko zerga-ordenantzak (PDF)».

Probatu hemen:

Ikusi adibide zuzenaren kodea
<style>
  .docs { list-style: none; padding: 0; }
  .docs li { margin: 8px 0; }
  .docs a { color: #412c56; }
  .docs img { vertical-align: middle; margin-left: 6px; }
</style>
<h2>Udal-araudia</h2>
<ul class="docs">
  <li><a href="#">2027ko zerga-ordenantzak
    <img src="data:image/svg+xml,…" alt="(PDF)" width="20" height="20"></a></li>
  <li><a href="#">2027ko ur-zerbitzuaren tasak
    <img src="data:image/svg+xml,…" alt="(PDF)" width="20" height="20"></a></li>
</ul>

Nola egiaztatu

Pantaila-irakurgailua (NVDA edo VoiceOver)

  1. Ibili esteketan zehar Tab teklarekin, edo ireki esteken zerrenda (NVDA: Insert + F7; VoiceOver: errotorea VO + U konbinazioarekin).
  2. Egiaztatu esteka bakoitzak dokumentuaren edo orriaren izena iragartzen duela. Ez luke iragarri behar helbiderik, fitxategi-izenik edo testu generikorik.
  3. Irudiak dituzten esteketan, egiaztatu alt testuak zerbait erabilgarria ematen duela, edo hutsik dagoela testua nahikoa bada.

Hau iragarri beharko luke: «esteka, 2027ko zerga-ordenantzak (PDF)»

Nabigatzailearen tresnak

  1. Ireki garapen-tresnak (F12), hautatu esteka bakoitza, eta begiratu Irisgarritasuna paneleko Izena eremua.
  2. Egiaztatu izena edukitik ateratzen dela (testua gehi irudien alt testua) eta jarraian irakurrita ulertzen dela.

Balidazio automatikoa

  1. axe DevToolsek (link-name) eta WAVEk («Empty link») izenik gabeko estekak detektatzen dituzte. axek (image-alt) alt atributurik gabeko irudiak detektatzen ditu.
  2. Ez dituzte detektatzen helbideak edo fitxategi-izenak diren esteka-testuak, ezta «icono-pdf.svg» bezalako alt testuak ere. WAVEk testu susmagarri batzuen berri eman dezake. Testuaren kalitatea eskuz berrikusten da.

Auditorietako ohiko akatsak

  • Helbidea edo fitxategiaren izena erabiltzea esteka-testu gisa deskargen zerrendetan.
  • Ikonoen alt testuan irudi-fitxategiaren izena uztea, edo «ikonoa» edo «irudia» bezalako testuak.
  • Estekaren testua irudiaren alt testuan errepikatzea; hala, irakurgailuak bi aldiz iragartzen du. Testua nahikoa bada, alt testua hutsik doa.
  • Fitxategiaren formatua edo tamaina ikonoarekin bakarrik adieraztea, hori esaten duen testu alternatiborik gabe.
Ikusi W3Cren testu osoa (euskarazko itzulpena)

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

Aplikagarritasuna

HTML dokumentuak, estekak (<a href> elementuak) dituztenak

Deskribapena

Teknika honen helburua da esteka baten helburua deskribatzea, a elementuaren eduki gisa testu deskribatzaile bat emanez. Deskribapenari esker, erabiltzaileak esteka hau web-orriko gainerako esteketatik bereiz dezake, eta esteka jarraitu ala ez erabakitzen laguntzen dio. Helmugaren URI-a, oro har, ez da behar bezain deskribatzailea.

Irudi bat esteka baten eduki bakarra denean, irudiaren testu-alternatibak estekaren funtzio zehatza deskribatzen du.

Esteka baten edukiak testua eta irudi bat edo gehiago dituenean, testua nahikoa bada estekaren helburua deskribatzeko, irudiek testu-alternatiba hutsa izan dezakete. (Ikus Testu alternatibo hutsa erabiltzea eta title atributurik ez erabiltzea img elementuetan, laguntza-teknologiak kontuan hartu behar ez dituen irudietarako.) Irudiek estekaren helburutik haratago doan informazioa transmititzen dutenean, alt testu egokia ere izan behar dute.

Adibideak

Esteka baten helburua HTMLn deskribatzea, a elementuaren testu-edukian.

<a href="routes.html">
  Current routes at Boulders Climbing Gym
</a>

img elementuaren alt atributua erabiltzea esteka grafiko baten helburua deskribatzeko.

<a href="routes.html">
  <img src="topo.gif" alt="Current routes at Boulders Climbing Gym"> 
</a> 

alt atributu hutsa erabiltzea aingura-elementuak (a), img elementuaz gain, estekaren helburua deskribatzen duen testu bat duenean. Kontuan izan estekaren testua orrian irudiaren ondoan agertuko dela.

<a href="routes.html">
  <img src="topo.gif" alt="">
  Current routes at Boulders Climbing Gym
</a>

Webgune batek aukera ematen die erabiltzaileei produktuei buruzko iritziak bidaltzeko, produktu bakoitzaren xehetasun-orriko "Feedback" (iritzia) estekan klik eginez. Beste erabiltzaile batzuek edozein iritziri erantzun diezaiokete. Erabiltzailearen iritziari erantzun bat dagoenean, iritzi-estekak ikono bat erakusten du "Feedback" testuaren ondoren, eta ikono horren testu-alternatiba "response received" (erantzuna jasota) da. Webgunearen laguntza-dokumentuak ikono hau komatxoak dituen bunbuilo gisa deskribatzen du, eta ikonoa, bere testu-alternatibarekin, adibide gisa sartzen du. Produktuen xehetasun-orrietan testu-alternatiba bera erabiltzen da (erantzun bat dagoenean), dokumentazioari jarraitzen dioten erabiltzaileek irudia dokumentatuta dagoen bezala zuzen identifika dezaten laguntzeko.

<a href="prod_123_feedback.html">
  Feedback 
  <img src="response.gif" width="15" height="15" alt="response received">
</a>

Esteka batek testua eta ikono bat ditu, eta ikonoak helmugari buruzko informazio gehigarria ematen du.

<a href="WMFP.pdf">
  Woodend Music Festival Program
  <img src="pdficon.gif" alt="PDF format">
</a>

"MyCorp" enpresaren urteko txostena enpresaren webgunean argitaratzen da PDF gisa, eta enpresaren urteko aurrekontua webgunean argitaratzen da Excel fitxategi gisa.

Erabiltzaile askok nahiago dute fitxategi mota ezagutu, fitxategi bat irekitzeak hura ikusteko aplikazio berri bat irekitzea dakarrenean; horregatik, maiz erabilgarritzat jotzen da informazio gehigarri hori sartzea. Hala ere, ez da nahitaezkoa betetze-irizpide hau betetzeko.

<ul>
  <li>
    <a href="2009mycorp_report.pdf">MyCorp 2009 Annual Report (PDF)</a>
  </li>
  <li>			
    <a href="2009mycorp_budget.xls">MyCorp 2009 Annual Budget (Excel)</a>
  </li>		
</ul>

Probak

Prozedura

Teknika hau erabiltzen duen edukiko esteka bakoitzerako:

  1. Egiaztatu a elementuak testua edo testua ez den edukiarentzako testu-alternatiba bat duela.
  2. img elementu bat a elementuaren eduki bakarra bada, egiaztatu haren testu-alternatibak estekaren helburua deskribatzen duela.
  3. a elementuak img elementu bat edo gehiago baditu eta img elementu horien testu-alternatiba hutsik badago, egiaztatu estekaren testuak estekaren helburua deskribatzen duela.
  4. a elementuak testua besterik ez badu, egiaztatu testuak estekaren helburua deskribatzen duela.

Espero diren emaitzak

  • Aurreko egiaztapenak egiazkoak dira.

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