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
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
- Jarri
idbakar bat izenaren parte den testu bakoitzari. - Idatzi eremuan
aria-labelledby,idhoriek zuriunez bereizita, irakurri behar diren ordenan. - Eremuaren balioa esaldiaren parte bada, sartu eremuaren beraren
id-a ere bere lekuan. Horrela, uneko balioa bere tokian irakurtzen da. - Taula batean, konbinatu errenkadaren izenburua eta zutabearena:
aria-labelledby="fila-lunes col-proyecto-a". - Gogoan izan
aria-labelledbyatributuak<label>etiketa ordezten duela. Haren testua mantendu nahi baduzu, sartu harenid-a ere zerrendan.
Nola egiaztatu
- Egiaztatu
aria-labelledbyatributukoidbakoitza orrian badagoela eta ez dagoela errepikatuta. - Nabigatzailearen tresnekin (F12, «Irisgarritasuna» panela), begiratu eremuaren izena («Name»). Zentzua duen esaldi gisa irakurri behar da.
- 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:
- Egiaztatu
aria-labelledbyatributuan erreferentziatutakoid-ak bakarrak direla eta bat datozela, guztien artean, etiketa ematen duten testu-nodoenid-ekin - Egiaztatu
aria-labelledbyatributuak 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
- HTML Accessibility API Mappings
- WAI-ARIA Authoring Practices Guide (WAI-ARIA egileentzako jardunbideen gida)
- Using ARIA: Practical Support: aria-label, aria-labelledby and aria-describedby (aria-label, aria-labelledby eta aria-describedby atributuen euskarri praktikoa)
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
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.