Tècnica ARIA WCAG 2.2
ARIA9Formar el nom d'un camp unint diversos textos amb aria-labelledby
Nom oficial al W3C: Utilitzar aria-labelledby per concatenar una etiqueta a partir de diversos nodes de text
En poques paraules
De vegades el nom d'un camp està repartit en diversos textos. Passa a «Amplia la sessió a [20] minuts» o a les files i columnes d'una taula. Amb aria-labelledby s'ajunten aquests textos en l'ordre desitjat. El lector de pantalla els llegeix com un únic nom.
Per què és important
Imagineu el camp de la frase «Amplia la sessió a … minuts». Si la seva etiqueta és només «Amplia la sessió a», la persona que utilitza un lector de pantalla no sap si ha d'escriure minuts o hores.
En una taula d'hores per dia i per projecte, cada casella necessita dues dades: la fila i la columna. Sense aquestes dades, l'usuari sent «camp d'edició» una vegada i una altra i no sap on escriu.
Com es fa
- Poseu un
idúnic a cada text que forma part del nom. - Escriviu al camp
aria-labelledbyamb aquestsidseparats per espais, en l'ordre en què s'han de llegir. - Si el valor del camp forma part de la frase, incloeu-hi també l'
iddel mateix camp en la seva posició. Així es llegeix el valor actual al lloc que li correspon. - En una taula, combineu l'encapçalament de la fila i el de la columna:
aria-labelledby="fila-lunes col-proyecto-a". - Recordeu que
aria-labelledbysubstitueix l'etiqueta<label>. Si en voleu conservar el text, incloeu-ne també l'ida la llista.
Com comprovar-ho
- Comproveu que cada
idd'aria-labelledbyexisteix a la pàgina i no està repetit. - Amb les eines del navegador (F12, tauler «Accessibilitat»), mireu el nom («Name») del camp. S'ha de llegir com una frase amb sentit.
- Amb un lector de pantalla, arribeu al camp amb el tabulador. Heu de sentir el nom complet en l'ordre correcte.
Exemple
Camp dins d'una frase per ampliar el temps d'una sessió; el seu nom serà «Amplia la sessió a 20 minuts».
<span id="txt-ampliar">Amplia la sessió a</span>
<input type="number" id="minutos" value="20"
aria-labelledby="txt-ampliar minutos txt-unidad">
<span id="txt-unidad">minuts</span>
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica ARIA9 de Techniques for WCAG 2.2, del W3C. Pot contenir errors. L'únic document oficial i normatiu és la versió original en anglès, publicada al lloc web del W3C.
Aplicabilitat
Tecnologies compatibles amb Accessible Rich Internet Applications (WAI-ARIA).
Descripció
La propietat aria-labelledby es pot utilitzar per proporcionar un nom a tots els objectes visuals. Aplicada als camps d'entrada, la propietat aria-labelledby serveix per donar nom tant a camps d'entrada nadius com a elements no nadius, per exemple camps de text personalitzats construïts amb div contenteditable="true".
Un ús concret d'aria-labelledby és el dels camps de text en situacions en què un nom significatiu ha d'estar format per més d'una cadena de text.
Qui desenvolupa assigna id únics a les cadenes de text d'etiqueta que es concatenaran com a nom de l'element input. El valor de l'atribut aria-labelledby és llavors una llista de tots els id separats per espais, en l'ordre en què els lectors de pantalla han de llegir les cadenes d'etiqueta referenciades. Els agents d'usuari compatibles concatenaran les cadenes d'etiqueta referenciades i les llegiran com un únic nom continu per al camp.
La concatenació de cadenes pot ser útil per diversos motius. A l'exemple 1, un camp d'entrada està niat dins del context d'una frase completa. La sortida desitjada del lector de pantalla és "Extend time-out to [ 20 ] minutes - edit with autocomplete, selected 20" (Amplia el temps d'espera a [ 20 ] minuts - edició amb compleció automàtica, seleccionat 20). Com que l'id del camp de text està inclòs a la cadena d'id referenciats per aria-labelledby, el valor del camp s'inclou en el nom concatenat en la posició correcta.
Una altra aplicació d'aria-labelledby es dona quan no hi ha espai per col·locar una etiqueta visible al costat del camp, o quan utilitzar etiquetes natives crearia una redundància innecessària. En aquests casos, l'ús d'aria-labelledby permet associar elements visibles de la pàgina com a nom d'aquests camps. Això es mostra a l'exemple 2, en què els encapçalaments de columna i de fila d'una taula es concatenen per formar els noms dels camps de text situats dins de la taula.
El document Accessible Name and Description Computation especifica que la cadena indicada a aria-labelledby ha de substituir el contingut de l'element que porta la propietat, i no afegir-s'hi. Així doncs, afegir la propietat aria-labelledby a una etiqueta nativa hauria de substituir el contingut textual d'aquesta etiqueta, tret que la mateixa etiqueta estigui referenciada com a part de la seqüència d'id d'aria-labelledby.
Exemples
Un camp de temps d'espera amb nom concatenat
Un camp de text permet als usuaris ampliar el temps predeterminat abans que s'esgoti el temps d'espera.
La cadena "Extend time-out to" (Amplia el temps d'espera a) està continguda en un element label natiu i s'associa al camp mitjançant id="timeout-duration". Aquesta etiqueta s'associa al camp mitjançant l'associació for/id només en els agents d'usuari que no són compatibles amb ARIA. En els agents d'usuari compatibles amb ARIA, l'associació for/id s'ignora i el nom del camp el proporciona únicament aria-labelledby, d'acord amb el càlcul del nom i la descripció accessibles d'HTML Accessibility API Mappings 1.0.
L'atribut aria-labelledby del camp de text fa referència a tres elements: (1) l'span que conté l'etiqueta nativa, (2) el camp de text que conté el text predeterminat '20' (recordeu que aquest camp no està etiquetat amb el text de l'etiqueta associada mitjançant for/id) i (3) la cadena 'minutes' (minuts) continguda en un span. Aquests elements s'han de concatenar per formar el nom complet del camp de text
<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>
Exemple funcional: Camp de temps d'espera amb etiqueta concatenada, adaptat d'«Easy ARIA tip #2: aria-labelledby and aria-describedby», un exemple elaborat per Marco Zehe.
Una taula de dades senzilla amb camps de text
Una taula de dades senzilla que conté camps de text. Les etiquetes dels camps es concatenen mitjançant aria-labelledby, que fa referència als encapçalaments de columna i de fila corresponents.
<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>
Exemple funcional: Ús d'aria-labelledby en una taula senzilla amb camps de text, basat en un exemple de Jim Thatcher.
Una taula de reserva de tallers d'un congrés
Una taula de reserva de tallers d'un congrés amb dos itineraris paral·lels permet als usuaris seleccionar el taller al qual volen assistir. En tabular per les caselles de selecció de la taula, es proporcionen com a nom concatenat de cada casella, mitjançant aria-labelledby, l'itinerari (1 o 2), el títol i el ponent del taller, seguits de l'etiqueta "Attend" (Assisteix-hi) de la casella adjacent.
<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>
Exemple funcional: Horari de reserva de tallers d'un congrés.
Proves
Procediment
Per als camps d'entrada que utilitzen aria-labelledby:
- Comprovar que els
idreferenciats aaria-labelledbysón únics i coincideixen amb elsiddels nodes de text que, en conjunt, proporcionen l'etiqueta - Comprovar que el contingut concatenat dels elements referenciats per
aria-labelledbydescriu el propòsit o la funció de l'element etiquetat
Resultats esperats
-
Les comprovacions núm. 1 i núm. 2 són certes.
Si aquesta és una tècnica suficient per a un criteri de conformitat, no superar aquest procediment de prova no significa necessàriament que el criteri de conformitat no s'hagi satisfet d'una altra manera, sinó només que aquesta tècnica no s'ha implementat correctament i no es pot utilitzar per declarar la conformitat.
Recursos
- HTML Accessibility API Mappings
- WAI-ARIA Authoring Practices Guide (guia de pràctiques d'autor de WAI-ARIA)
- Using ARIA: Practical Support: aria-label, aria-labelledby and aria-describedby (suport pràctic d'aria-label, aria-labelledby i aria-describedby)
Com ho comprovem a ADDAW
En cada auditoria d'ADDAW revisem aquesta tècnica pàgina per pàgina i us lliurem els errors amb captures i la manera de corregir-los.
Basat en la tècnica ARIA9 del W3C (WCAG 2.2). Explicació i exemples: ADDAW. Traducció no oficial del text del W3C © W3C, llicència de documents del W3C. Heu vist un error? Escriviu-nos.