Tabela de dados
Tabela com ordenação, paginação e estados vazios. Com `onRowClick`, passe `rowLabel` para dar nome à linha clicável.
Quando usar
Para exibir listas de dados tabulares com ordenação e paginação. Ideal para listas de registros, relatórios e resultados de busca.
Quando não usar
Para dados simples sem necessidade de ordenação, use Table. Para listas com muitas colunas ou filtros avançados, considere um componente dedicado.
Acessibilidade
- Tabela semântica com role="table" e headers com scope="col".
- Paginação com role="navigation" e aria-label="Paginação".
- Colunas ordenáveis indicam direção com aria-sort.
Preview
Variantes e composição
| Prop / grupo | Valores |
|---|---|
props | columns · data · sortKey · sortDir · onSort · page · pageCount · onPageChange · onRowClick · rowLabel?: (row, index) => string (aria-label da linha; use com onRowClick) · emptyMessage · caption · labels (sortBy: descrição "Ordenar por …" do botão de ordenação, via aria-describedby, não o nome dele · pageOf · previous · next) |
a11y | columnheader e botão de ordenação nomeados só pela coluna; "Ordenar por …" como descrição (aria-describedby) · aria-sort no cabeçalho ordenado · botão de ordenação com alvo de 44px · linha focável e ativável por Enter/Espaço quando há onRowClick · rowLabel nomeia a linha clicável · cliques e teclas em controles da célula (e em portais abertos por ela) não ativam a linha · rodapé empilha abaixo de sm · paginação com alvos de 44px |