Table
Nenhuma fonte cobre tudo deste componente: o ponto em aberto está na seção "Para o desenvolvimento". Se você testou na implementação, conte o que viu nos comentários.
| Versões do DS | V3 |
| Papel (role) | table (com row, columnheader, cell) |
| Elemento HTML | <table><caption> com <th scope="col|row"> e <td> |
| Classe / componente | br-table |
| Origem | A documentação do DS não cobre o essencial: completado pela curadoria com o padrão do W3C (WAI-ARIA APG) e o eMAG. |
Documentação oficial: gov.br/ds.
Nome acessível
O nome da tabela vem do <caption> (ou aria-labelledby); cada célula é lida com seu cabeçalho de coluna e linha. Exemplo: Processos em andamento.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, tabela, {total} linhas · célula: {nome}, coluna, linha
Estados
Coluna ordenada
- No código:
aria-sort="ascending|descending" no <th> - Acrescenta ao anúncio: ordenado de forma crescente / decrescente
Linha selecionada
- No código:
checkbox por linha com nome ("Selecionar linha {n}") e aria-selected se usar grid - Acrescenta ao anúncio: selecionada
Resultado da busca mudou
- No código:
região viva aria-live="polite" com a contagem - Acrescenta ao anúncio: {total} resultados
Teclado
| Tecla | O que faz |
|---|---|
| Tab / Shift+Tab | Move entre os controles da tabela (busca, ordenação, ações, seleção) |
| Enter ou Espaço | Ativa botão de ordenação, ação ou checkbox em foco |
Para o desenvolvimento
br-table (V3). Use <table> semântica com <caption> e <th scope>; não use tabelas para diagramação. O core traz busca com role="searchbox", menu de ações com role="menu"/"menuitem" e uma região aria-live="polite" na barra. A confirmar: o core não mostra aria-sort nas colunas ordenáveis nem nome de linha nos checkboxes de seleção.
Fontes
- DS gov.br V3 · @govbr-ds/core — Table (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Table Pattern
- eMAG 3.1 · eMAG 3.1 — Recomendação 3.9 (em tabelas, utilizar títulos e resumos de forma apropriada)
- eMAG 3.1 · eMAG 3.1 — Recomendação 3.10 (associar células de dados às células de cabeçalho)
Comentários e evolução
Viu algo a corrigir ou completar nesta especificação? Comente abaixo dizendo qual parte, o que mudar e a fonte (WCAG, eMAG, WAI-ARIA APG, documentação do DS gov.br ou teste com leitor de tela). É preciso uma conta no GitHub. As sugestões aceitas entram na base e aparecem nas Novidades.