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

Tècnica HTML WCAG 2.2

H63Utilitzar scope per unir els encapçalaments amb les seves cel·les a les taules

Nom oficial al W3C: Utilitzar l'atribut scope per associar les cel·les d'encapçalament amb les cel·les de dades a les taules de dades

Versión en castellano

En poques paraules

En una taula de dades, cada encapçalament es marca amb th, i el seu atribut scope diu a quines dades afecta. scope="col" indica que encapçala una columna i scope="row", que encapçala una fila. Així el lector de pantalla anuncia l'encapçalament correcte en llegir cada dada.

Per què és important

Qui fa servir un lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla) recorre la taula cel·la per cel·la. Si la dada no està unida al seu encapçalament, només sent «19.30» i no sap a quin dia ni a quina activitat correspon.

En taules molt simples, el navegador endevina bé els encapçalaments. Però falla quan l'encapçalament de fila no és a la primera columna o quan un encapçalament abasta un grup. L'atribut scope ho deixa clar.

Com es fa

  1. Marqueu cada encapçalament amb <th>, mai amb un <td> en negreta.
  2. Als encapçalaments de columna, poseu scope="col".
  3. Als encapçalaments de fila, poseu scope="row", encara que no siguin a la primera columna.
  4. Si un encapçalament abasta un grup de files o de columnes, feu servir scope="rowgroup" o scope="colgroup".
  5. Si la taula té encapçalaments de diversos nivells, feu servir id i headers, o dividiu-la en taules més simples.

Exemple pràctic

L'horari d'activitats d'un poliesportiu municipal és una taula de dades simple. Però la dada clau de cada fila, l'activitat, no és a la primera columna. És a la segona, després del número d'ordre.

Així no: Encapçalament de fila marcat com a cel·la de dades

El nom de l'activitat és en un td amb strong. Per això el navegador no el tracta com a encapçalament de fila. En baixar per la columna «Hora» amb un lector de pantalla només se sent «19.30». No se sap a quina activitat correspon.

Captura de pantalla de l'exemple incorrecte: Encapçalament de fila marcat com a cel·la de dades
Així es veu l'exemple incorrecte.

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

Mostra el codi de l'exemple incorrecte
<style>
  table { border-collapse: collapse; }
  caption { font-weight: bold; text-align: left; margin-bottom: 6px; }
  th, td { border: 1px solid #767676; padding: 4px 10px; text-align: left; }
</style>
<table>
  <caption>Horari d'activitats dirigides</caption>
  <tr><th>Núm.</th><th>Activitat</th><th>Dia</th><th>Hora</th></tr>
  <tr><td>1</td><td><strong>Pilates</strong></td><td>Dilluns</td><td>18.00</td></tr>
  <tr><td>2</td><td><strong>Ioga</strong></td><td>Dimarts</td><td>19.30</td></tr>
  <tr><td>3</td><td><strong>Natació infantil</strong></td><td>Dimecres</td><td>17.00</td></tr>
</table>

Així sí: th amb scope="col" i scope="row"

Les cel·les de la primera fila són th scope="col". L'activitat de cada fila passa a ser th scope="row". Així cada dada queda unida a la seva columna i a la seva activitat, encara que l'encapçalament de fila no sigui a la primera columna.

Proveu-ho aquí:

Mostra el codi de l'exemple correcte
<style>
  table { border-collapse: collapse; }
  caption { font-weight: bold; text-align: left; margin-bottom: 6px; }
  th, td { border: 1px solid #767676; padding: 4px 10px; text-align: left; }
</style>
<table>
  <caption>Horari d'activitats dirigides</caption>
  <tr><th scope="col">Núm.</th><th scope="col">Activitat</th><th scope="col">Dia</th><th scope="col">Hora</th></tr>
  <tr><td>1</td><th scope="row">Pilates</th><td>Dilluns</td><td>18.00</td></tr>
  <tr><td>2</td><th scope="row">Ioga</th><td>Dimarts</td><td>19.30</td></tr>
  <tr><td>3</td><th scope="row">Natació infantil</th><td>Dimecres</td><td>17.00</td></tr>
</table>

Com comprovar-ho

Revisió del codi

  1. En cada taula de dades, localitzar quines cel·les fan d'encapçalament de columna i de fila.
  2. Comprovar que són th. Si l'encapçalament de fila no és a la primera columna o la taula no és simple, han de portar scope amb el valor row, col, rowgroup o colgroup.

Lector de pantalla (NVDA o VoiceOver)

  1. Entrar a la taula (tecla T a NVDA) i situar-se a la cel·la «18.00».
  2. Baixar per la columna amb Ctrl+Alt+fletxa avall (NVDA) o VO+fletxa avall (VoiceOver). A cada cel·la s'ha d'anunciar l'activitat de la fila.
  3. Moure's en horitzontal amb Ctrl+Alt+fletxa dreta. S'ha d'anunciar l'encapçalament de columna.

Hauria d'anunciar: A l'hora del ioga, alguna cosa com «Ioga, fila 3, 19.30». Les paraules exactes depenen del lector i de la seva versió.

Eines del navegador

  1. Obrir les eines de desenvolupament (F12), pestanya Accessibilitat, i seleccionar la cel·la de l'activitat.
  2. Comprovar que la seva funció és rowheader. Les cel·les de la primera fila han de ser columnheader.

Validació automàtica

  1. axe DevTools comprova que els valors de scope són vàlids (regla scope-attr-valid). També que els th tenen cel·les associades (regla th-has-data-cells).
  2. No detecta que l'activitat hauria de ser un encapçalament de fila. Una cel·la de dades que fa d'encapçalament només es descobreix revisant la taula a mà.

Errors freqüents en auditories

  • Encapçalaments de columna o de fila fets amb td i negreta (strong, b o CSS), en lloc de th.
  • Escriure scope="column" o scope="fila". Són valors que no existeixen i el navegador els ignora.
  • Resoldre només amb scope taules amb encapçalaments de diversos nivells o amb cel·les combinades. Necessiten id i headers, o dividir-se en taules més simples.
  • Posar scope en cel·les td. És un ús obsolet en HTML i no garanteix la unió amb les dades.
Veure el text complet del W3C (traducció al català)

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

L'objectiu d'aquesta tècnica és associar les cel·les d'encapçalament amb les cel·les de dades en taules complexes mitjançant l'atribut scope. L'atribut scope es pot utilitzar per aclarir l'abast de qualsevol cel·la que actuï com a encapçalament. L'atribut scope identifica si la cel·la és un encapçalament d'una fila, d'una columna o d'un grup de files o de columnes. Els valors row, col, rowgroup i colgroup identifiquen, respectivament, aquests abasts possibles.

Aquesta tècnica es pot utilitzar en taules de dades simples en què l'encapçalament no és a la primera fila o columna, com la de l'exemple 1.

En les taules simples que tenen els encapçalaments a la primera fila o columna, n'hi ha prou d'utilitzar els elements th sense scope.

En les taules complexes, feu servir id i headers tal com s'indica a Utilitzar els atributs id i headers per associar les cel·les de dades amb les cel·les d'encapçalament a les taules de dades.

A alguns usuaris els pot resultar més fàcil treballar amb diverses taules simples que amb una sola taula més complexa. Els autors poden plantejar-se si és possible convertir les taules complexes en una o diverses taules simples.

Exemples

Un horari simple

En l'exemple següent, la primera columna conté els números d'ordre de les files de la taula, i la segona columna conté el valor clau de la fila. Per tant, les cel·les de la segona columna poden utilitzar scope="row". Les cel·les de la primera fila també es marquen amb td i utilitzen scope="col".

<table>
  <caption>Contact Information</caption>
  <tr>
    <td></td>
    <th scope="col">Name</th>
    <th scope="col">Phone Number</th>
    <th scope="col">City</th>
  </tr>
  <tr>
    <td>1.</td>
    <th scope="row">Charlotte Smith</th>
    <td>412-212-5421</td>
    <td>Pittsburgh</td>
  </tr>
  <tr>
    <td>2.</td>
    <th scope="row">Joetta Frere</th>
    <td>410-306-5400</td>
    <td>Baltimore</td>
  </tr>
  <tr>
    <td>3.</td>
    <th scope="row">David Walls</th>
    <td>281-511-6600</td>
    <td>New York</td>
  </tr>
</table> 

Proves

Procediment

Per a cada taula de dades:

  1. Comprovar que tots els elements th tenen un atribut scope.
  2. Comprovar que tots els atributs scope tenen el valor row, col, rowgroup o colgroup.

Resultats esperats

  • Totes les comprovacions anteriors són certes.

Recursos

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.

Sol·licitar una auditoria

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