Addaw, anar a la pàgina d'inici Donar

Error habitual WCAG 2.2

F44Ordre de tabulació desordenat per usar tabindex amb números

Nom oficial al W3C: Error del criteri de conformitat 2.4.3 per utilitzar tabindex per crear un ordre de tabulació que no conserva el significat ni l'operabilitat

Versión en castellano

En poques paraules

L'atribut tabindex amb valors positius (1, 2, 3…) canvia l'ordre en què es recorre la pàgina amb la tecla Tab. Si aquests números no segueixen l'ordre lògic del contingut, el focus salta d'un lloc a un altre sense sentit. És un error freqüent quan s'edita una pàgina i s'oblida tornar a numerar.

Per què és important

Moltes persones usen només el teclat: persones cegues amb lector de pantalla, persones amb poca mobilitat a les mans o qui prefereix no usar el ratolí. Amb la tecla Tab passen d'un enllaç o camp al següent.

Si l'ordre salta sense lògica, la persona perd el fil. En un formulari de cita prèvia pot arribar a la data abans que al nom. O pot arribar al botó «Envia» sense haver passat per un camp.

Com evitar-ho

  1. Deixeu que l'ordre el marqui el codi: col·loqueu els elements a l'HTML en el mateix ordre en què s'han de recórrer.
  2. No useu valors de tabindex més grans que 0. Els elements amb número positiu van sempre abans que la resta de la pàgina.
  3. Useu tabindex="0" només perquè un control propi rebi el focus en la seva posició natural. Useu tabindex="-1" per donar-li el focus només des d'un script.
  4. Si el disseny canvia l'ordre visual amb CSS, reordeneu l'HTML en lloc de corregir-ho amb tabindex.
  5. Si hereteu una pàgina amb tabindex positius, traieu-los. Si no és possible, reviseu tota la numeració cada vegada que afegiu o moveu un element.

Exemple pràctic

És habitual en formularis de cita prèvia, contacte o registre. L'ordre es va fixar amb tabindex positius. Després es va afegir un camp, que va quedar fora de la seqüència.

Així no: Formulari amb tabindex positius i un camp afegit després

Els camps porten tabindex de l'1 al 4. El camp Telèfon es va afegir més tard, sense tabindex. Amb Tab, l'ordre és Nom, Cognoms, Data de la cita i Demana cita. Telèfon se salta i arriba l'últim, després del botó d'enviament.

Captura de pantalla de l'exemple incorrecte: Formulari amb tabindex positius i un camp afegit després
Així es veu l'exemple incorrecte.

La demostració conté, a propòsit, l'error d'accessibilitat que s'explica.

Veure el codi de l'exemple incorrecte
<form action="#">
  <p><label for="nombre">Nom</label><br>
    <input id="nombre" type="text" autocomplete="given-name" tabindex="1"></p>
  <p><label for="apellidos">Cognoms</label><br>
    <input id="apellidos" type="text" autocomplete="family-name" tabindex="2"></p>
  <p><label for="tel">Telèfon</label><br>
    <input id="tel" type="tel" autocomplete="tel"></p>
  <p><label for="fecha">Data de la cita</label><br>
    <input id="fecha" type="date" tabindex="3"></p>
  <button type="submit" tabindex="4">Demana cita</button>
</form>

Així sí: Formulari sense tabindex: l'ordre segueix el codi

Es treuen tots els tabindex. Ara l'ordre de tabulació és el del codi. Coincideix amb l'ordre visual i lògic: Nom, Cognoms, Telèfon, Data de la cita i Demana cita. Els camps que s'afegeixin en el futur quedaran al seu lloc sense tocar res més.

Proveu-ho aquí:

Veure el codi de l'exemple correcte
<form action="#">
  <p><label for="nombre">Nom</label><br>
    <input id="nombre" type="text" autocomplete="given-name"></p>
  <p><label for="apellidos">Cognoms</label><br>
    <input id="apellidos" type="text" autocomplete="family-name"></p>
  <p><label for="tel">Telèfon</label><br>
    <input id="tel" type="tel" autocomplete="tel"></p>
  <p><label for="fecha">Data de la cita</label><br>
    <input id="fecha" type="date"></p>
  <button type="submit">Demana cita</button>
</form>

Com comprovar-ho

Teclat

  1. Prémer Tab des de l'inici de la pàgina. Anotar l'ordre en què els controls reben el focus.
  2. Comprovar que aquest ordre segueix la lectura (de dalt a baix i d'esquerra a dreta) i la lògica de la tasca.
  3. Comprovar que cap camp no queda al final, després del botó d'enviament o del peu de pàgina.

Eines del navegador

  1. A Firefox, obrir les eines de desenvolupament (F12) i la pestanya Accessibilitat. Activar «Mostra l'ordre de tabulació» per veure la seqüència numerada sobre la pàgina.
  2. Per llistar els elements amb tabindex positiu, executar a la Consola: document.querySelectorAll('[tabindex]:not([tabindex="0"]):not([tabindex^="-"])')

Validació automàtica

  1. axe DevTools (regla tabindex) i Lighthouse avisen dels elements amb tabindex més gran que 0. WAVE també els assenyala com a alerta.
  2. Aquestes eines detecten els tabindex positius, però no saben si l'ordre és lògic. L'error es confirma recorrent la pàgina amb el teclat.

Errors freqüents en auditories

  • Posar tabindex="1" al cercador o al botó de galetes perquè rebin el focus primer. Així cal passar-hi abans que per l'enllaç per saltar al contingut.
  • Formularis de connectors o constructors visuals que numeren els camps amb tabindex. En afegir o moure camps, l'ordre es desordena.
  • Barrejar tabindex positius en una finestra modal i en la resta de la pàgina. El focus surt de la finestra modal abans d'acabar-la.
  • Corregir amb tabindex positius un ordre visual canviat amb CSS (order, flex-direction: row-reverse). El correcte és reordenar el codi font.
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica F44 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

HTML

Descripció

Aquest document descriu un error que es produeix quan l'ordre de tabulació no segueix les relacions i les seqüències lògiques del contingut.

Els elements que poden rebre el focus, com els enllaços i els elements de formulari, tenen un atribut tabindex. Els elements reben el focus en ordre ascendent segons el valor de l'atribut tabindex. Quan els valors de l'atribut tabindex s'assignen en un ordre diferent del de les relacions i seqüències del contingut, l'ordre de tabulació deixa de seguir les relacions i seqüències del contingut.

Una de les causes més habituals d'aquest error es dona quan s'edita una pàgina en què s'ha usat tabindex. És fàcil que l'ordre de tabulació i l'ordre del contingut deixin de correspondre's quan s'edita el contingut però no s'actualitzen els atributs tabindex per reflectir els canvis fets.

Exemples

L'exemple següent usa tabindex de manera incorrecta per especificar un ordre de tabulació alternatiu:

<ol>
  <li><a href="main.html" tabindex="1">Homepage</a></li>
  <li><a href="chapter1.html" tabindex="4">Chapter 1</a></li>
  <li><a href="chapter2.html" tabindex="3">Chapter 2</a></li>
  <li><a href="chapter3.html" tabindex="2">Chapter 3</a></li>
</ol>

Si es navega per aquesta llista amb la tecla de tabulació, es recorre en l'ordre «Homepage», «chapter 3», «chapter 2», «chapter 1» (pàgina d'inici, capítol 3, capítol 2, capítol 1), que no segueix la seqüència del contingut.

En una pàgina web s'ha fixat explícitament l'ordre de tabulació assignant atributs tabindex a tots els camps. Més endavant es modifica la pàgina per afegir un camp nou al mig de la pàgina, però qui la desenvolupa oblida afegir un atribut tabindex al nou camp. Com a resultat, el nou camp queda al final de l'ordre de tabulació.

Proves

Procediment

  1. Si s'usa tabindex, comprovar que l'ordre de tabulació especificat pels atributs tabindex segueix les relacions existents en el contingut.

Resultats esperats

  • Si la comprovació núm. 1 és falsa, es dona aquesta condició d'error i el contingut incompleix el criteri de conformitat.

Recursos

Com ho comprovem a ADDAW

Aquest error és un dels que busquem en cada auditoria d'ADDAW. Us el lliurem amb captures i la manera de corregir-lo.

Sol·licitar una auditoria

Basat en la tècnica F44 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.