Addaw, joan hasierara Egin dohaintza

Teknika ARIA WCAG 2.2

ARIA6Elementu bati aria-label bidez izena ematea testu ikusgairik ez dagoenean

Izen ofiziala W3Cn: aria-label erabiltzea objektuei etiketak emateko

Versión en castellano · Versió en català

Laburbilduz

aria-label atributuak izen ikusezin bat ematen dio elementu bati: ikono bat besterik ez duen botoi bati, menu bati edo orriko eremu bati. Pantaila-irakurgailuak izen hori irakurtzen du, pertsonak jakin dezan zer den. Orrian izen gisa balio duen testu ikusgairik ez dagoenean erabiltzen da.

Zergatik da garrantzitsua

Webgune askok testurik gabeko ikonoak erabiltzen dituzte: bilatzailearen lupa, saskia edo menuaren hiru marrak. Pantaila ikusten duenak marrazkiagatik ezagutzen ditu. Pantaila-irakurgailu batek (pantaila ozen irakurtzen duen programa), aldiz, «botoia» besterik ez du esaten.

Orri berean bi menu daudenean ere laguntzen du. «Menu nagusia» eta «Oineko menua» bezalako izenekin, pertsonak badaki zeinetan dagoen.

Nola egiten da

  1. Gehitu aria-label, elementuak zer egiten duen edo zer den esaten duen testu labur batekin; adibidez, aria-label="Bilatu".
  2. Erabili izena onartzen duten elementuetan: botoietan, esteketan, eremuetan, <nav> bezalako eskualdeetan edo role bat duten elementuetan. Rolik gabeko <div> edo <span> batean ez du funtzionatzen.
  3. Izen gisa balio duen testu ikusgai bat badago jada, hobe da <label> edo aria-labelledby erabiltzea.
  4. Gogoan izan aria-label atributuak elementuaren berezko izena ordezten duela, hala nola irudi baten alt edo eremu baten <label>.
  5. Elementuak aria-labelledby ere badu, horrek irabazten du eta aria-label ez da kontuan hartzen.
  6. Idatzi testua orriaren hizkuntzan eta «botoia» hitzik gabe: irakurgailuak iragartzen du jada mota.

Adibide praktikoa

Lineako denda baten goiburua, hiru botoirekin: bilatu, saskia eta menua. Botoi bakoitzak SVG ikono bat besterik ez du erakusten. Orrian ez dago botoi horiei izen gisa balio diezaiekeen testurik.

Horrela ez: Izenik gabeko ikono-botoiak

Ikonoak ezkutatuta daude pantaila-irakurgailuentzat, eta botoiek ez dute testurik. Horregatik, irakurgailuak hiru aldiz esaten du «botoia», bakoitzak zer egiten duen azaldu gabe. Horretaz ohartzeko, ibili barran zehar Tab teklarekin, NVDA edo VoiceOver aktibatuta duzula.

Adibide okerraren pantaila-argazkia: Izenik gabeko ikono-botoiak
Honela ikusten da adibide okerra.

Erakustaldiak nahita dauka azaltzen den irisgarritasun-errorea.

Ikusi adibide okerraren kodea
<div class="barra">
  <button type="button">
    <svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><circle cx="10" cy="10" r="6" fill="none" stroke="#0B2239" stroke-width="2"/><line x1="15" y1="15" x2="21" y2="21" stroke="#0B2239" stroke-width="2"/></svg>
  </button>
  <button type="button">
    <svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M2 4h3l3 11h11l2-8H6" fill="none" stroke="#0B2239" stroke-width="2"/><circle cx="9" cy="20" r="1.5" fill="#0B2239"/><circle cx="18" cy="20" r="1.5" fill="#0B2239"/></svg>
  </button>
  <button type="button">
    <svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M3 6h18M3 12h18M3 18h18" stroke="#0B2239" stroke-width="2"/></svg>
  </button>
</div>
<style>
  .barra { display: flex; gap: .5em; }
  .barra button { background: #fff; border: 1px solid #744E9A; border-radius: 4px; padding: .4em; line-height: 0; }
  .barra button:focus-visible { outline: 3px solid #0B2239; outline-offset: 2px; }
</style>

Horrela bai: Izena duten botoiak, aria-label-i esker

Botoi bakoitzak bere funtzioa esaten duen aria-label bat du: «Bilatu», «Saskia» eta «Menua». Ikonoak aria-hidden bidez ezkutatuta jarraitzen du. Horrela, izena aria-label-etik bakarrik ateratzen da eta ez da errepikatzen.

Probatu hemen:

Ikusi adibide zuzenaren kodea
<div class="barra">
  <button type="button" aria-label="Bilatu">
    <svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><circle cx="10" cy="10" r="6" fill="none" stroke="#0B2239" stroke-width="2"/><line x1="15" y1="15" x2="21" y2="21" stroke="#0B2239" stroke-width="2"/></svg>
  </button>
  <button type="button" aria-label="Saskia">
    <svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M2 4h3l3 11h11l2-8H6" fill="none" stroke="#0B2239" stroke-width="2"/><circle cx="9" cy="20" r="1.5" fill="#0B2239"/><circle cx="18" cy="20" r="1.5" fill="#0B2239"/></svg>
  </button>
  <button type="button" aria-label="Menua">
    <svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M3 6h18M3 12h18M3 18h18" stroke="#0B2239" stroke-width="2"/></svg>
  </button>
</div>
<style>
  .barra { display: flex; gap: .5em; }
  .barra button { background: #fff; border: 1px solid #744E9A; border-radius: 4px; padding: .4em; line-height: 0; }
  .barra button:focus-visible { outline: 3px solid #0B2239; outline-offset: 2px; }
</style>

Nola egiaztatu

Pantaila-irakurgailua (NVDA edo VoiceOver)

  1. Ibili barran zehar Tab teklarekin eta entzun nola iragartzen den botoi bakoitza.
  2. Egiaztatu aria-label-eko testuak zehatz esaten duela botoiak zer egiten duen.

Hau iragarri beharko luke: «Bilatu, botoia»; «Saskia, botoia»; «Menua, botoia»

Nabigatzailearen tresnak

  1. Ireki garapen-tresnak (F12), joan «Irisgarritasuna» panelera eta hautatu botoi bakoitza.
  2. Egiaztatu izena («Name») aria-label-etik ateratzen dela eta ez dagoela hutsik.
  3. Egiaztatu botoiak ez duela aria-labelledby ere. Izango balu, aria-label-i irabaziko lioke, eta aria-label ez litzateke kontuan hartuko.

Teklatua

  1. Ibili botoietan zehar Tab teklarekin. Bakoitzak foku ikusgarriaren adierazle bat erakutsi behar du, hau da, non dagoen markatzen duen laukia.

Balidazio automatikoa

  1. axe DevToolsek adibide okerreko izenik gabeko botoiak detektatzen ditu (button-name araua). WAVEk «Empty button» gisa markatzen ditu.
  2. Tresna horiek ez dakite aria-label-eko testua egokia den. aria-label="ikonoa" edo «1. botoia» batek proba automatikoa gainditzen du.

Auditorietako ohiko akatsak

  • Funtziorik gabeko div edo span batean aria-label jartzea. Hor ez dago baimenduta, eta pantaila-irakurgailuek ez dute kontuan hartzen.
  • Botoi edo esteka batean haren testu ikusgaiaz bestelako aria-label bat jartzea. Izenak testu ikusgaia eduki behar du (2.5.3 irizpidea).
  • Ingelesezko izenak edo ikonoaren izenetik kopiatutakoak («search», «icon-cart») uztea euskarazko orri batean.
  • aria-label gabeko nav eskualde batzuk izatea, edo denak izen berarekin. Horrela, ezin dira bereizi eskualdeen zerrendan.
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko ARIA6 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 objektuei laguntza-teknologiek irakur dezaketen etiketa bat ematea. aria-label atributuak objektu baten testu-etiketa ematen du, botoi batena adibidez. Pantaila-irakurgailu batek objektua aurkitzen duenean, aria-label atributuko testua irakurtzen du, eta horrela erabiltzaileak badaki zer den.

Garatzaileek kontuan izan behar dute laguntza-teknologiek aria-label ez ikusi egin dezaketela objektu berean aria-labelledby erabiltzen denean. Izenak esleitzeko hierarkiari buruzko informazio gehiago izateko, kontsultatu Accessible Name And Description Computation gomendioaren accessible name and description computation atala. Kontuan izan behar dute, halaber, aria-label erabiltzeak izena esleitzeko edozein mekanismo natibo baliogabetuko duela, hala nola irudien alt edo formularioko eremu bati for atributuaren bidez lotutako label.

Adibideak

Nabigazio-eskualdeak bereiztea

Ondorengo adibideak erakusten du nola erabil litekeen aria-label HTML dokumentu bateko bi nabigazio-eskualde (landmark) bereizteko, orri berean mota bereko bi eskualde baino gehiago daudenean eta orrian etiketa gisa erreferentzia egin dakiokeen testurik ez dagoenean.

<div role="navigation" aria-label="Primary">
  <ul>
    <li>...a list of links here ...</li>
  </ul>
</div>
<div role="navigation" aria-label="Secondary">
  <ul>
    <li>...a list of links here ...</li>
  </ul>
</div>

Eskualde generikoak identifikatzea

Ondorengo adibideak erakusten du nola gehi litekeen "region" eskualde (landmark) generiko bat eguraldiaren portlet bati. Orrian ez dago etiketa gisa erreferentzia egin dakiokeen testurik; beraz, aria-label bidez etiketatzen da.

<div role="region" aria-label="weather portlet">
  ...
</div>

Eduki matematikoari etiketa bat ematea

Jarraian, MathML-ko funtzio baten adibide bat erakusten da; math rola, etiketa egoki bat eta MathML-ko adierazpena erabiltzen ditu:

<div role="math" aria-label="6 divided by 4 equals 1.5">
  <math xmlns="https://www.w3.org/1998/Math/MathML">
    <mfrac>
      <mn>6</mn>
      <mn>4</mn>
    </mfrac>
      <mo>=</mo>
      <mn>1.5</mn>
  </math>
</div>

Probak

Prozedura

aria-label atributua duen elementu bakoitzerako.

  1. Aztertu testu-deskribapenak objektua zehatz etiketatzen duen, haren helburua deskribatzen duen edo informazio baliokidea ematen duen.

Espero diren emaitzak

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