Tabela de dados

Tabela com ordenação, paginação e estados vazios. Com `onRowClick`, passe `rowLabel` para dar nome à linha clicável. No código: data-table — src/components/data-table.tsx · Conteúdo e dados

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 / grupoValores
propscolumns · 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)
a11ycolumnheader 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

Uso

Fonte do componente