Resumos para tabelas

A Silktide procura tabelas de dados que não tenham um resumo a descrever a sua finalidade e estrutura. Um resumo fornece às pessoas que não conseguem ver a tabela uma visão geral antes de começarem a lê-la, para que saibam o que esperar e como está organizada.

Esta é uma verificação assistida: a Silktide não consegue determinar se uma determinada tabela é suficientemente complexa para precisar de um resumo, por isso apresenta candidatos para que os reveja.

Porque é importante

Um leitor que vê a tabela capta imediatamente a sua forma — quantas colunas tem, o que contêm e onde procurar. Um utilizador de não tem acesso a nada disso: a tabela é lida célula a célula e, no caso de uma tabela complexa, pode ser necessário um esforço considerável só para perceber como está organizada. Uma descrição breve no início — «trimestres nas colunas, linhas de produtos nas linhas» — evita esse esforço e permite ao ouvinte decidir se vale a pena explorar a tabela.

As tabelas simples raramente precisam disto; as complexas beneficiam muito.

Como corrigir

Decida se é necessário explicar a estrutura da tabela. Uma tabela pequena com uma única linha de cabeçalho clara geralmente não precisa; uma tabela com células unidas, vários níveis de cabeçalho ou abreviaturas geralmente precisa.
Se for necessário, adicione um atributo summary a descrever como a tabela está organizada — sem repetir o título:

<!-- O resumo explica a estrutura; a legenda fornece o título -->
<table summary="Trimestres nas colunas, linhas de produtos nas linhas; todos os valores em dólares americanos">
  <caption>Vendas de 2026</caption>
  ...
</table>

Se a tabela for simples e autoexplicativa, não é necessária qualquer alteração — pode o resultado.

Como a Silktide testa isto

Encontra todas as tabelas em cada página.
Ignora as tabelas marcadas como apresentacionais com role="presentation".
Ignora as tabelas com apenas uma linha ou apenas uma coluna, que provavelmente não são tabelas de dados.
Apresenta cada tabela restante cujo atributo summary esteja ausente ou vazio, para que a reveja.

Resolução de problemas

O atributo summary não está obsoleto?

Sim — summary provém do HTML 4 e está obsoleto no atual, embora os leitores de ecrã continuem a anunciá-lo. Se preferir alternativas modernas, um parágrafo visível antes da tabela ou uma descrição associada através de aria-describedby funciona para mais utilizadores. Tenha em atenção que esta verificação deteta apenas o próprio atributo summary, pelo que uma tabela descrita de outra forma continuará a ser apresentada — nesse caso, aprove o resultado.

O resumo repete a minha legenda

Um resumo que apenas duplica a legenda visível não acrescenta nada e é apresentado por uma verificação separada — consulte Resumo e legenda de tabela idênticos.