Pular para o conteúdo principal

Table

A confirmar

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 DSV3
Papel (role)table (com row, columnheader, cell)
Elemento HTML<table><caption> com <th scope="col|row"> e <td>
Classe / componentebr-table
OrigemA 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

Comportamento esperado, não a fala exata: NVDA, JAWS, VoiceOver e TalkBack variam. No plugin, cada elemento tem um campo para o resultado do teste com leitor de tela real.

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​

TeclaO que faz
Tab / Shift+TabMove entre os controles da tabela (busca, ordenação, ações, seleção)
Enter ou EspaçoAtiva botão de ordenação, ação ou checkbox em foco
Fonte: curadoria (WAI-ARIA APG).

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​

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.