Addaw, joan hasierara Egin dohaintza

Teknika ARIA WCAG 2.2

ARIA9Eremu baten izena hainbat testu elkartuz osatzea aria-labelledby bidez

Izen ofiziala W3Cn: aria-labelledby erabiltzea etiketa bat testu-nodo batzuetatik abiatuta kateatzeko

Versión en castellano · Versió en català

Laburbilduz

Batzuetan, eremu baten izena hainbat testutan banatuta dago. «Luzatu saioa [20] minutura» bezalako esaldietan gertatzen da, edo taula bateko errenkadetan eta zutabeetan. aria-labelledby erabiliz, testu horiek nahi den ordenan elkartzen dira. Pantaila-irakurgailuak izen bakar gisa irakurtzen ditu.

Zergatik da garrantzitsua

Pentsa ezazu «Luzatu saioa … minutura» esaldiko eremuan. Haren etiketa «Luzatu saioa» bakarrik bada, pantaila-irakurgailua erabiltzen duen pertsonak ez daki minutuak ala orduak idatzi behar dituen.

Eguneko eta proiektuko orduen taula batean, gelaxka bakoitzak bi datu behar ditu: errenkada eta zutabea. Horiek gabe, erabiltzaileak «edizio-eremua» entzuten du behin eta berriz, eta ez daki non idazten ari den.

Nola egiten da

  1. Jarri id bakar bat izenaren parte den testu bakoitzari.
  2. Idatzi eremuan aria-labelledby, id horiek zuriunez bereizita, irakurri behar diren ordenan.
  3. Eremuaren balioa esaldiaren parte bada, sartu eremuaren beraren id-a ere bere lekuan. Horrela, uneko balioa bere tokian irakurtzen da.
  4. Taula batean, konbinatu errenkadaren izenburua eta zutabearena: aria-labelledby="fila-lunes col-proyecto-a".
  5. Gogoan izan aria-labelledby atributuak <label> etiketa ordezten duela. Haren testua mantendu nahi baduzu, sartu haren id-a ere zerrendan.

Nola egiaztatu

  1. Egiaztatu aria-labelledby atributuko id bakoitza orrian badagoela eta ez dagoela errepikatuta.
  2. Nabigatzailearen tresnekin (F12, «Irisgarritasuna» panela), begiratu eremuaren izena («Name»). Zentzua duen esaldi gisa irakurri behar da.
  3. Pantaila-irakurgailu batekin, iritsi eremura tabuladorearekin. Izen osoa entzun behar duzu, ordena zuzenean.

Adibidea

Saio baten denbora luzatzeko esaldi baten barruko eremua; haren izena «Luzatu saioa 20 minutura» izango da.

<span id="txt-ampliar">Luzatu saioa</span>
<input type="number" id="minutos" value="20"
       aria-labelledby="txt-ampliar minutos txt-unidad">
<span id="txt-unidad">minutura</span>
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko ARIA9 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

aria-labelledby propietatea objektu bisual guztiei izena emateko erabil daiteke. Sarrera-eremuei aplikatuta, aria-labelledby propietateak balio du bai sarrera-eremu natiboei bai elementu ez-natiboei izena emateko; adibidez, div contenteditable="true" erabiliz eraikitako testu-eremu pertsonalizatuei.

aria-labelledby atributuaren erabilera zehatz bat testu-eremuena da, izen esanguratsu bat testu-kate bat baino gehiagoz osatu behar den egoeretan.

Garatzaileak id bakarrak esleitzen dizkie input elementuaren izen gisa kateatuko diren etiketa-testuko kateei. Orduan, aria-labelledby atributuaren balioa id guztien zerrenda bat da, zuriunez bereizita, pantaila-irakurgailuek erreferentziatutako etiketa-kateak irakurri behar dituzten ordenan. Erabiltzaile-agente bateragarriek erreferentziatutako etiketa-kateak kateatu egingo dituzte, eta eremuaren izen jarraitu bakar gisa irakurriko dituzte.

Kateak kateatzea baliagarria izan daiteke hainbat arrazoirengatik. 1. adibidean, sarrera-eremu bat esaldi oso baten testuinguruan txertatuta dago. Pantaila-irakurgailuaren nahi den irteera hau da: "Extend time-out to [ 20 ] minutes - edit with autocomplete, selected 20" (Luzatu itxaron-denbora [ 20 ] minutura - edizioa osatze automatikoarekin, 20 hautatuta). Testu-eremuaren id-a aria-labelledby atributuak erreferentziatutako id katean sartuta dagoenez, eremuaren balioa kateatutako izenean sartzen da, posizio zuzenean.

aria-labelledby atributuaren beste aplikazio bat eremuaren ondoan etiketa ikusgai bat jartzeko lekurik ez dagoenean gertatzen da, edo etiketa natiboak erabiltzeak alferreko erredundantzia sortuko lukeenean. Kasu horietan, aria-labelledby erabiliz, orriko elementu ikusgaiak eremu horien izen gisa lot daitezke. Hori 2. adibidean erakusten da: taula bateko zutabe- eta errenkada-izenburuak kateatu egiten dira taularen barruan dauden testu-eremuen izenak osatzeko.

Accessible Name and Description Computation dokumentuak zehazten du aria-labelledby atributuan adierazitako kateak propietatea duen elementuaren edukia ordeztu egin behar duela, ez hari gehitu. Beraz, etiketa natibo bati aria-labelledby propietatea gehitzeak etiketa horren testu-edukia ordeztu beharko luke, etiketa bera aria-labelledby atributuko id sekuentziaren parte gisa erreferentziatuta ez badago behintzat.

Adibideak

Izen kateatua duen itxaron-denboraren eremu bat

Testu-eremu batek aukera ematen die erabiltzaileei itxaron-denbora agortu aurreko denbora lehenetsia luzatzeko.

"Extend time-out to" (Luzatu itxaron-denbora) katea label elementu natibo batean dago, eta id="timeout-duration" bidez lotzen da eremuarekin. Etiketa hori for/id loturaren bidez lotzen da eremuarekin, baina ARIArekin bateragarriak ez diren erabiltzaile-agenteetan bakarrik. ARIArekin bateragarriak diren erabiltzaile-agenteetan, for/id lotura ez da kontuan hartzen, eta eremuaren izena aria-labelledby atributuak bakarrik ematen du, HTML Accessibility API Mappings 1.0 dokumentuko izen eta deskribapen irisgarrien kalkuluaren arabera.

Testu-eremuaren aria-labelledby atributuak hiru elementuri egiten die erreferentzia: (1) etiketa natiboa duen span elementuari, (2) '20' testu lehenetsia duen testu-eremuari (gogoan izan eremu hori ez dagoela for/id bidez lotutako etiketaren testuarekin etiketatuta) eta (3) span batean dagoen 'minutes' (minutu) kateari. Elementu horiek kateatu egin behar dira testu-eremuaren izen osoa osatzeko

<div>
  <span id="timeout-label">
    <label for="timeout-duration">Extend time-out to</label>
  </span>
  <input type="text" size="3" id="timeout-duration" value="20" 
   aria-labelledby="timeout-label timeout-duration timeout-unit">
  <span id="timeout-unit"> minutes</span>
</div>

Adibide funtzionala: Etiketa kateatua duen itxaron-denboraren eremua, «Easy ARIA tip #2: aria-labelledby and aria-describedby» adibidetik egokitua; Marco Zehek egin zuen adibide hori.

Testu-eremuak dituen datu-taula sinple bat

Testu-eremuak dituen datu-taula sinple bat. Eremuen etiketak aria-labelledby bidez kateatzen dira, eta atributu horrek dagozkion zutabe- eta errenkada-izenburuei egiten die erreferentzia.

<table>
  <tr>
    <td></td>
    <th id="tpayer">Taxpayer</th>
    <th id="sp">Spouse</th>
  </tr>
  <tr>
    <th id="gross">W2 Gross</th>
    <td><input type="text" size="20" aria-labelledby="tpayer gross"></td>
    <td><input type="text" size="20" aria-labelledby="sp gross"></td>
  </tr>
  <tr>
    <th id="divi">Dividends</th>
    <td><input type="text" size="20" aria-labelledby="tpayer divi"></td>
    <td><input type="text" size="20" aria-labelledby="sp divi"></td>
  </tr>
</table>

Adibide funtzionala: aria-labelledby erabiltzea testu-eremuak dituen taula sinple batean, Jim Thatcherren adibide batean oinarritua.

Biltzar bateko tailerrak erreserbatzeko taula bat

Bi ibilbide paraleloko biltzar bateko tailerrak erreserbatzeko taula batek aukera ematen die erabiltzaileei joan nahi duten tailerra hautatzeko. Taulako kontrol-laukietan zehar tabuladorearekin ibiltzean, lauki bakoitzaren izen kateatu gisa ematen dira, aria-labelledby bidez, ibilbidea (1 edo 2), tailerraren izenburua eta hizlaria, eta ondoren ondoko laukiaren "Attend" (Joan) etiketa.

<h1>Dinosaur Conference workshops timetable Thursday, 14 & Friday, 15 March 2013</h1>
<table>
  <caption>Dinosaur Conference workshop booking table</caption>
  <tr>
    <th rowspan="2" scope="col">Track</th>
    <th colspan="2" scope="colgroup">Thursday</th>
    <th colspan="2" scope="colgroup">Friday</th>
  </tr>
  <tr>
    <th scope="col" id="am1">9 to 12 AM</th>
    <th scope="col" id="pm1">2 to 5 PM</th>
    <th scope="col" id="am2">9 to 12 AM</th>
    <th scope="col" id="pm2">2 to 5 PM</th>
  </tr>
  <tr>
    <th id="track1" scope="row">Track 1</th>
    <td>
      <h2 id="title-TM1">The Paleozoic era </h2>
      <p>2 places left</p>
      <input type="checkbox" id="TM1" aria-labelledby="title-TM1 track1 am1 TM1-att">
      <label id="TM1-att" for="TM1">Attend</label>
    </td>
    <td>
      <h2 id="title-TA1">The Mesozoic era overview</h2>
      <p>2 places left</p>
      <input type="checkbox" id="TA1" aria-labelledby="title-TA1 track1 am2 TA1-att">
      <label id="TA1-att" for="TA1">Attend</label>
    </td>
    <td>
      <h2 id="title-FM1">The Triassic period, rise of the dinosaurs</h2>
      <p>1 place left</p>
      <input type="checkbox" id="FM1" aria-labelledby="title-FM1 track1 pm1 FM1-att">
      <label id="FM1-att" for="FM1">Attend</label>
    </td>
    <td>
      <h2 id="title-FA1">The Jurassic period</h2>
      <p>11 places left</p>
      <input type="checkbox" id="FA1" aria-labelledby="title-FA1 track1 pm2 FA1-att">
      <label id="FA1-att" for="FA1">Attend</label>
    </td>
  </tr>
  <tr>
    <th id="track2" scope="row">Track 2</th>
    <td>
      <h2 id="title-TM2">The Cretaceous period</h2>
      <p>18 places left</p>
      <input type="checkbox" id="TM2" aria-labelledby="title-TM2 track2 am1 TM2-att">
      <label id="TM2-att" for="TM2">Attend</label>
   </td>
   <td>
      <h2 id="title-TA2">The end of the dinosaurs</h2>
      <p>2 places left</p>
      <input type="checkbox" id="TA2" aria-labelledby="title-TA2 track2 am2 TA2-att">
      <label id="TA2-att" for="TA2">Attend</label>
    </td>
    <td>
      <h2 id="title-FM2">First discoveries of dinosaurs</h2>
      <p>2 places left</p>
      <input type="checkbox" id="FM2" aria-labelledby="title-FM2 track2 pm1 FM2-att">
      <label id="FM2-att" for="FM2">Attend</label>
    </td>
    <td>
      <h2 id="title-FA2">Emerging scholarship</h2>
      <p>19 places left</p>
      <input type="checkbox" id="FA2" aria-labelledby="title-FA2 track2 pm2 FA2-att">
      <label id="FA2-att" for="FA2">Attend</label>
    </td>
  </tr>
</table>

Adibide funtzionala: Biltzar bateko tailerrak erreserbatzeko ordutegia.

Probak

Prozedura

aria-labelledby erabiltzen duten sarrera-eremuetarako:

  1. Egiaztatu aria-labelledby atributuan erreferentziatutako id-ak bakarrak direla eta bat datozela, guztien artean, etiketa ematen duten testu-nodoen id-ekin
  2. Egiaztatu aria-labelledby atributuak erreferentziatutako elementuen eduki kateatuak etiketatutako elementuaren helburua edo funtzioa deskribatzen duela

Espero diren emaitzak

  • 1. eta 2. egiaztapenak egiazkoak dira.

    Teknika hau betetze-irizpide baterako teknika nahikoa bada, proba-prozedura hau ez gainditzeak ez du nahitaez esan nahi betetze-irizpidea beste modu batean bete ez denik; teknika hau behar bezala inplementatu ez dela eta betetzea adierazteko erabili ezin dela baizik.

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