DataTable
Com dados
| Pedido | Cliente | Valor | Situação |
|---|---|---|---|
| 10231 | Marina Toledo | R$ 2,5K | Entregue |
| 10232 | Rafael Quintana | R$ 940 | Em trânsito |
Carregando
| Pedido | Cliente | Valor | Situação |
|---|---|---|---|
Erro
Não foi possível carregar os pedidos
O servidor da loja não respondeu. Tente de novo em alguns minutos.
Vazio
Nenhum pedido por aqui
Quando a loja vender pela primeira vez, o pedido aparece nesta lista.
Ordenável
| Situação | |||
|---|---|---|---|
| 10231 | Marina Toledo | R$ 2,5K | Entregue |
| 10232 | Rafael Quintana | R$ 940 | Em trânsito |
| 10233 | Helena Barros | R$ 1,6K | Entregue |
| 10234 | Júlio Andrade | R$ 310 | Em trânsito |
| 10235 | Sofia Lemos | R$ 75 | Entregue |
| 10236 | Caio Ferraz | R$ 5,2K | Entregue |
| 10237 | Beatriz Nunes | R$ 890 | Em trânsito |
Com busca
| Situação | |||
|---|---|---|---|
| 10231 | Marina Toledo | R$ 2,5K | Entregue |
| 10232 | Rafael Quintana | R$ 940 | Em trânsito |
| 10233 | Helena Barros | R$ 1,6K | Entregue |
| 10234 | Júlio Andrade | R$ 310 | Em trânsito |
| 10235 | Sofia Lemos | R$ 75 | Entregue |
| 10236 | Caio Ferraz | R$ 5,2K | Entregue |
| 10237 | Beatriz Nunes | R$ 890 | Em trânsito |
Com paginação
| Situação | |||
|---|---|---|---|
| 10231 | Marina Toledo | R$ 2,5K | Entregue |
| 10232 | Rafael Quintana | R$ 940 | Em trânsito |
| 10233 | Helena Barros | R$ 1,6K | Entregue |
| 10234 | Júlio Andrade | R$ 310 | Em trânsito |
1–4 de 7
Com seleção
| Situação | ||||
|---|---|---|---|---|
| 10231 | Marina Toledo | R$ 2,5K | Entregue | |
| 10232 | Rafael Quintana | R$ 940 | Em trânsito | |
| 10233 | Helena Barros | R$ 1,6K | Entregue | |
| 10234 | Júlio Andrade | R$ 310 | Em trânsito |
1–4 de 7
1 pedido selecionado
Virtualizada
| Evento |
|---|
Totais que acompanham a busca
| Situação | |||
|---|---|---|---|
| 10231 | Marina Toledo | R$ 2,5K | Entregue |
| 10232 | Rafael Quintana | R$ 940 | Em trânsito |
| 10233 | Helena Barros | R$ 1,6K | Entregue |
| 10234 | Júlio Andrade | R$ 310 | Em trânsito |
| Total | R$ 11,5K |
1–4 de 7
Total grudado no rodapé da moldura
| Situação | |||
|---|---|---|---|
| 10231 | Marina Toledo | R$ 2,5K | Entregue |
| 10232 | Rafael Quintana | R$ 940 | Em trânsito |
| 10233 | Helena Barros | R$ 1,6K | Entregue |
| 10234 | Júlio Andrade | R$ 310 | Em trânsito |
| 10235 | Sofia Lemos | R$ 75 | Entregue |
| 10236 | Caio Ferraz | R$ 5,2K | Entregue |
| 10237 | Beatriz Nunes | R$ 890 | Em trânsito |
| Total | R$ 11,5K |
No servidor: a página e a ordem vêm de fora
| Situação | |||
|---|---|---|---|
| 10231 | Marina Toledo | R$ 2,5K | Entregue |
| 10232 | Rafael Quintana | R$ 940 | Em trânsito |
| 10233 | Helena Barros | R$ 1,6K | Entregue |
1–3 de 7
Revalidando, com a última busca que falhou
Não foi possível atualizar
Os dados abaixo são da última busca que deu certo.
| Pedido | Cliente | Valor | Situação |
|---|---|---|---|
| 10231 | Marina Toledo | R$ 2,5K | Entregue |
| 10232 | Rafael Quintana | R$ 940 | Em trânsito |
import { DataTable } from '@rivocode/ui'Quando usar
Tabela com os três estados que toda listagem tem e quase nenhuma trata: carregando, erro e vazio.
Não conhece React Query, e isso é de propósito: entram três booleanos, e funciona
igual com fetch na mão, com SWR ou com server component.
A ordem importa: erro vence carregando, e vazio só vale depois que a consulta voltou. Sem isso, uma nova busca sobre um erro pisca "nenhum resultado" antes de mostrar o problema.
Ordenar, buscar, paginar, selecionar
Tudo opt-in, tudo client-side, nada muda para quem não pedir:
sortablena coluna: o cabeçalho vira botão que alterna crescente, decrescente, sem ordem. Quandocelldevolve JSX, entregue o valor cru emvalue, senão a ordem compara o que estiver emrow[key]. A seta é uma só e gira meia volta ao inverter o sentido, no tempo--rc-duration-base: trocar o desenho de uma vez fazia a inversão passar despercebida, e é ela que diz que a lista embaixo virou de ponta-cabeça.filterna tabela, filtro global controlado: o app põe o campo de busca onde a tela pedir e passa o texto; a tabela compara ignorando caixa e acento ("otica" acha "Ótica"). Sem resultado, uma linha discreta explica. Oemptycontinua reservado para consulta que voltou vazia.pageSize, paginação com rodapé: "1–4 de 7" à esquerda, as páginas à direita. Filtrar ou reordenar volta para a primeira página. Comcaption, a região da paginação se chama "Paginação:", e duas tabelas na mesma página não geram duas regiões de nome igual; labels.pagination.navigationvence esse nome.selectable: coluna de checkbox à esquerda, chaves dorowKey, aviso emonValueChange. Passevaluepara controlar de fora, oudefaultValuepara só dizer com o que ela começa, o mesmo par doTreee doTreeSelect. O checkbox do cabeçalho marca a página visível, não a lista inteira.
A linha de totais
Toda listagem financeira brasileira termina em "Total: R$ 248,3K". Montada numa
<div> embaixo da tabela, essa linha perde o alinhamento das colunas (uma
<div> não participa do algoritmo de layout de tabela e não conhece a largura
de nenhuma delas) e, com maxHeight, some ao rolar.
O total é por coluna, e é o irmão do cell uma linha acima: onde o cell
resume uma linha, o total resume a coluna inteira. Basta uma coluna declarar
total para o <tfoot> existir; as outras saem em branco, alinhadas com quem
está em cima.
const COLUMNS: Column<Order>[] = [
{ key: 'number', header: 'Pedido', total: () => 'Total' },
{ key: 'customer', header: 'Cliente' },
{
key: 'amount',
header: 'Valor',
align: 'right',
cell: (order) => currencyShort(order.amount),
total: (orders) => currencyShort(orders.reduce((sum, i) => sum + i.amount, 0)),
},
]
Alinhamento à direita, hideOnMobile e o grudar embaixo com maxHeight vêm de
graça: a célula do total já é a célula daquela coluna. O dinheiro sai
abreviado, como no resto da casa: currency por extenso fica para onde o
centavo é o assunto.
As linhas que chegam ao total são as que sobraram do filtro, de todas as
páginas. O rodapé de paginação ao lado já conta assim ("1–4 de 7" conta o que
sobrou da busca), e um total que mudasse a cada virada de página não seria um
total de nada. Carregando não há rodapé (não há o que somar), e busca sem
resultado também não: a linha que explica já ocupa a tabela inteira.
Por que não um footer?: (rows) => ReactNode: ele devolveria o problema de onde
ele veio. Quem escrevesse teria de montar a <tr> e as <td> na mão, contar as
colunas escondidas no celular e repetir o alinhamento de cada uma, e errar em
qualquer um desses é voltar a ter o total fora de eixo, agora dentro de uma
tabela. Para o arranjo que uma coluna não alcança (célula que junta duas
colunas, duas linhas de resumo), o caminho é o Table com TableFooter, que
existe justamente para a tabela que você desenha.
classNames.footer continua sendo a barra de paginação debaixo da tabela, e não
esta linha: a linha de totais se veste pelo que o total de cada coluna
devolve.
No celular: quantas colunas cabem
A 390px cabem quatro colunas curtas, contando a caixa de marcar do
selectable: uma listagem com número, cliente, situação e valor já passa da
largura. O caminho é hideOnMobile nas colunas que a pessoa não precisa
para decidir (cidade, data do pedido, responsável), e não deixar a tabela
rolar de lado: a coluna de dinheiro, alinhada à direita, é a primeira a sair da
vista.
Cada coluna escolhe a largura em que aparece. showFrom diz a partir de
qual ponto ela entra (sm 640px, md 768px, lg 1024px, xl 1280px), e
hideFrom a partir de qual ela sai. O hideOnMobile é o mesmo que
showFrom="sm". Com os dois, a tabela muda de forma em cada largura sem
nenhuma linha de CSS na tela: no celular, um resumo; no tablet, as colunas que
decidem; na mesa, todas.
const columns: Column<Order>[] = [
{ key: 'number', header: 'Pedido' },
{
key: 'summary',
header: 'Cliente e itens',
hideFrom: 'md',
cell: (order) => `${order.customer} · ${order.items}`,
},
{ key: 'customer', header: 'Cliente', showFrom: 'md' },
{ key: 'items', header: 'Itens', showFrom: 'lg' },
{ key: 'placedAt', header: 'Feito em', showFrom: 'xl' },
{ key: 'status', header: 'Situação' },
]
Quando ainda assim a tabela não cabe, a moldura rola, e diz que rola: a borda
do lado que tem conteúdo escondido esmaece, como a da FilterBar, e o
esmaecido muda de lado conforme a pessoa rola. A moldura também vira parada de
Tab com o nome do caption e rola pelas setas. Quem só tem o dedo vê a borda
apagada; quem só tem o teclado chega pelo Tab.
Os textos que a peça escreve
Eram cravados, e nenhum tinha prop:
errorTitle(padrão "Não foi possível carregar") eerrorMessagesão o par do estado de erro. Uma tela que carrega três listagens precisa dizer qual delas falhou. OChartContainerusa os mesmos dois nomes.errorIllustrationé o desenho do erro que toma a página ou a seção (ServerError, ou o Bacalhau triste em produto da RivoCode). Com ele, o aviso vira oResultde perigo, com o desenho em cima e o botão doonRetryembaixo. O mesmo nome doQueryBoundarye doChartContainer.labels.retry(padrão "Tentar de novo") é o nome do botão que executa oonRetry. Ele existe pelo mesmo motivo doerrorTitle, e com a mesma chave nas peças de consulta: sem ele, a tela em outra língua saía com o título traduzido e o botão em português.noResultsMessage(padrão "Nenhum resultado para a busca.") é a linha discreta de quando o filtro zerou. Ela não se confunde com oempty: filtro que zerou não é consulta vazia, e o remédio de um (limpar a busca) não serve ao outro.
errorTitle, errorMessage, errorIllustration e noResultsMessage valem igual no DataList do
React Native, com uma diferença de padrão: lá o aviso de erro nasceu de uma linha só, então errorTitle aparece
apenas quando você passa um. Sem ele, quem fala é a errorMessage; com errorIllustration, o título do desenho é "Não foi possível carregar".
Muita linha: rolagem própria e virtualização
Entre "cabe numa página" e "manda para o servidor" existe o caso do meio, que é
onde mora um painel de log: dezenas de milhares de linhas, e ainda assim
ordenar e buscar precisam funcionar. Paginar no servidor resolve o volume e
custa sortable e filter: a peça volta a ser tabela crua.
<DataTable
data={events} // 80 mil linhas
columns={COLUMNS} // com sortable à vontade
rowKey={(event) => event.id}
filter={search}
maxHeight={480}
virtual
/>
São duas props, e elas são independentes de propósito:
maxHeightdá à tabela uma moldura com rolagem própria: ela rola por dentro em vez de empurrar a página, e o cabeçalho gruda no topo dessa moldura (--rc-z-sticky, abaixo de menu, diálogo e toast). Sozinha, ela não virtualiza nada: todas as linhas continuam no DOM, e isso basta até uns poucos milhares.virtualdesenha só as linhas que cabem na moldura. Precisa demaxHeight: sem altura não há o que caber. Não combine compageSize: paginar já resolve o mesmo problema de outro jeito.rowHeight(padrão 44) é a altura da linha virtualizada, e a peça a aplica. Não é chute: o espaço de quem não foi desenhado sai dessa multiplicação, e linha que cresce faz a rolagem prometer um fim que não chega. Numa lista densa, ou com célula de duas linhas, passe a sua.
Ela continua saindo como <table> de verdade. O jeito comum de virtualizar
(cada linha em position: absolute com translateY) quebraria isso: linha
absoluta sai do algoritmo de layout de tabela, e com ela vão a largura de coluna
compartilhada e o alinhamento entre cabeçalho e célula. O que sobra é uma grade
de div com cara de tabela. Aqui as linhas visíveis ficam em fluxo normal e o
espaço de quem não foi desenhado vira duas linhas vazias, uma antes e uma
depois, com a altura que falta. O <tbody> continua tendo só <tr> por filho,
e cada <tr> só <td>.
As linhas vazias saem do fluxo do leitor de tela com aria-hidden, e quem
carrega a contagem certa é o aria-rowcount da tabela mais o aria-rowindex de
cada linha, senão a lista seria anunciada como "12 linhas" no meio de oitenta
mil.
No servidor: rowCount
Quando a lista não cabe no cliente, quem ordena, filtra e pagina é o servidor, e
a tabela só mostra a página que veio. rowCount é o que liga esse modo: com
ele, a tabela deixa de ordenar, filtrar e cortar o data por conta própria, e o
rodapé conta o total do servidor, e não as linhas que chegaram.
const [sorting, setSorting] = useState<DataTableSorting | null>(null)
const [pagination, setPagination] = useState<DataTablePagination>({ page: 1, pageSize: 20 })
const query = useQuery({
queryKey: ['pedidos', sorting, pagination, search],
queryFn: () => fetchOrders({ sorting, pagination, search }),
placeholderData: keepPreviousData,
})
<DataTable
data={query.data?.items}
rowCount={query.data?.total ?? 0}
columns={COLUMNS} // sortable continua valendo
rowKey={(order) => order.id}
filter={search}
sorting={sorting}
onSortingChange={setSorting}
pagination={pagination}
onPaginationChange={setPagination}
isLoading={query.isPending}
isFetching={query.isFetching}
isRefetchError={query.isRefetchError}
onRetry={query.refetch}
/>
sortingeonSortingChange: o cabeçalho pede a próxima ordem (crescente, decrescente,null) e mostra a de agora emaria-sorte na seta. Odatajá tem que vir nessa ordem.paginationeonPaginationChange: a página conta do 1, como noPagination. Trocar a ordem pede a primeira página. O par vale também semrowCount, para controlar a paginação no cliente.filterno modo servidor só decide o texto da tabela vazia: com busca, a página vazia diznoResultsMessage; sem busca, mostra oempty. Quem filtra é a consulta, e voltar para a primeira página quando a busca muda é de quem controla apagination.
Sem rowCount, o cabeçalho ordenável ordena só a página que chegou: o resultado
errado que não avisa. Com rowCount e sortable mas sem onSortingChange, a
peça avisa no console, e o mesmo para a paginação sem onPaginationChange.
A revalidação: isFetching e isRefetchError
Os mesmos dois nomes e o mesmo desenho do QueryBoundary, e das irmãs
VirtualList, ChartContainer, EventCalendar e Gantt:
isFetchingcomdatana mão: as linhas ficam, a tabela ganhaaria-busy, e uma barra fina corre no topo dela. Trocar de página comkeepPreviousDatacai aqui, e não no esqueleto.isRefetchErrorcomdatana mão vence oisError: as linhas ficam, e um aviso acima diz que a lista está desatualizada, com o botão doonRetry. Antes, uma revalidação que falhava (sinal ruim, servidor fora) apagava a listagem que a pessoa estava lendo. Sem dado, é o erro de sempre.
labels.refreshing nomeia a barra, labels.refetchError e labels.stale são o
título e a linha do aviso, e classNames.refreshing e classNames.stale vestem
os dois.
A espera se anuncia
A espera se anuncia em voz alta. aria-busy num nó sem papel não é lido por
leitor de tela nenhum: ele descreve o estado de uma região, e só chega a quem já
está dentro dela. Quem esperava ouvia silêncio, e a chegada do dado, que troca a
tela inteira, também não dizia nada. As quatro irmãs publicam a mesma região viva
(role="status" aria-live="polite", marcada com data-rc-status), que diz
"Carregando…" enquanto a consulta não volta e "Conteúdo carregado" quando ela
volta. Ela existe antes de o texto mudar e é o mesmo nó do primeiro ao último
estado: região que nasce já com o texto dentro não dispara anúncio nenhum.
Movimento
O corpo da tabela esmaece uma vez quando sai do esqueleto para as linhas (animate-appear, --rc-duration-base), inteiro, e não linha a linha: ordenar move as linhas no DOM, e a animação presa na linha recomeçaria a cada clique no cabeçalho. Com "reduzir movimento", as linhas aparecem paradas.
Quando não usar
Para a tabela que você desenha linha a linha, use Table. Ela compõe com
TableRow, TableCell e TableFooter, e aceita qualquer arranjo: célula que
junta duas colunas, duas linhas de resumo, o quadro de um recibo. Esta aqui
recebe columns e data, e essa é a troca: ela cuida dos estados e da ordenação, e em compensação
o desenho de cada linha passa a caber no que uma coluna sabe fazer.
iOS e Android
O puxar para atualizar do DataList (onRefresh e refreshing) é desenhado pelo sistema: no iOS o giro aparece acima da lista enquanto ela estica; no Android um disco desce por cima da lista. A cor é a da casa nos dois: o giro em accent-text e, no Android, o disco em surface-raised.
No React Native
Vira DataList. Tabela não existe no celular: o que atravessa é a máquina de estados (carregando, erro, vazio, dados) na mesma ordem, com o erro vencendo o carregando e o vazio valendo só depois que a resposta chegou. Os textos desses finais se configuram com os nomes do web: errorTitle, errorMessage, labels.retry e noResultsMessage, todos string porque texto aqui mora dentro de um Text. Só o padrão de errorTitle difere: aqui não há, porque o aviso da lista nasceu de uma linha só, e essa linha é a errorMessage. Dos quatro opt-in daqui, dois portam com o mesmo nome de prop (filter e selectable, com a seleção em value e onValueChange) e dois não portam por desenho: ordenação e pageSize. Cabeçalho clicável não existe sem cabeçalho, e no celular ordenar é um Menu de "ordenar por" que a tela monta em cima da lista. No lugar das colunas, renderItem. E por isso o filter quer um filterValue, já que ninguém consegue ler texto de dentro do JSX que você devolve.
O modo servidor do web (rowCount, sorting, pagination) também não porta, pelo mesmo motivo: sem cabeçalho e sem rodapé de páginas, a tela pede a próxima página e a ordem nova do jeito dela. A revalidação porta com os nomes do web: isFetching deixa as linhas, diz busy e corre a barra fina no topo, e isRefetchError com dado na mão mantém as linhas com o aviso de atenção acima delas, com as chaves refreshing, refetchError e stale em labels.
A lista é uma FlatList, e virtualiza de fábrica. Ela encolhe para caber no pai e rola por dentro; para ocupar a tela, className="flex-1". Dentro de uma ScrollView, passe scrollEnabled={false}: quem rola é a tela, e a lista cresce com o conteúdo. onRefresh liga o puxar para atualizar do sistema, e refreshing diz quando o giro para. A linha que abre tem pelo menos 44 pontos de altura.
O className veste a raiz em todo final: a lista, o carregando, o erro (com a caixa vermelha dentro dela, e não virando ela), o vazio e a busca que zerou. O respiro e o flex-1 não somem quando a consulta falha. O vazio mora dentro da FlatList, como ListEmptyComponent, e por isso o puxar para atualizar continua valendo com a lista vazia; ele cresce na altura da lista e fica no meio dela. A busca que zerou vai no mesmo lugar.
A rolagem infinita fala os nomes do useInfiniteQuery. onEndReached recebe o fetchNextPage e é chamado com meia tela de folga antes do fim; hasNextPage falso, isFetchingNextPage ou isFetchNextPageError seguram o pedido, para a lista não pedir a mesma página duas vezes. Buscando, o rodapé gira com "Carregando mais…"; se a página falhar, as linhas ficam e o rodapé diz "Não foi possível carregar mais." com o botão "Tentar de novo", que chama o onEndReached outra vez. Os textos são loadingMore e nextPageError em labels.
O que só existe aqui, porque o dedo pede. labels.selectRow aceita a função da linha, para cada caixa ter nome próprio ((nota) => `Selecionar a nota ${nota.number}` ), e não oito "Selecionar linha" seguidos no leitor de tela. onRowLongPress é o toque longo que entra em seleção: quem chama liga o selectable e marca a linha tocada, e o leitor de tela oferece o gesto como ação (labels.longPress). header é o que rola junto com as linhas, o ListHeaderComponent da FlatList, e fica na tela também no carregando, no erro, no vazio e na busca que zerou, para a busca escrita nele não sumir; stickyHeaderIndices e onScroll atravessam para a FlatList, e stickyHeaderIndices={[0]} prende o header.
No iOS e no Android. Ao chegar no fim da rolagem, o iOS estica com mola e o Android estica a borda (Android 12 ou mais novo) ou mostra o brilho (até o 11). É o gesto do sistema, e a peça não o troca. O puxar para atualizar também é o do sistema: no iOS a lista desce com mola e o giro aparece em cima; no Android o círculo desce por cima da lista.
API
| Prop | Tipo | Padrão |
|---|---|---|
columnsobrigatória0.4.0 | Column<Row>[] | sem padrão |
dataobrigatória0.4.0 | Row[] | undefined | sem padrão |
rowKeyobrigatória0.4.0Identidade da linha. | (row: Row, index: number) => string | sem padrão |
caption0.4.0A legenda da tabela, lida so pelo leitor de tela. | string | sem padrão |
classNames0.5.0Classe por parte: `table`, `head`, `row`, `cell`, `footer`. | Partial<Record<"cell" | "footer" | "head" | "refreshing" | "row" | "stale" | "table", string>> | sem padrão |
defaultValueAs chaves marcadas de saida, quando a tabela controla a propria selecao. | string[] | sem padrão |
empty0.4.0O que aparece quando a consulta volta vazia. | { title: ReactNode; description: ReactNode; action?: ReactNode; icon?: ReactNode; illustration?: ReactNode; } | sem padrão |
errorIllustrationO desenho do erro de pagina ou de secao: o `ServerError` de `@rivocode/ui/illustrations`, ou o Bacalhau `pose="sad" motion="shake"` em produto da RivoCode. | ReactNode | sem padrão |
errorMessage0.4.0 | ReactNode | "Não foi possível carregar a lista." |
errorTitleO titulo do aviso de erro. | ReactNode | "Não foi possível carregar" |
filter0.4.0Filtro global controlado: o app poe o campo de busca onde quiser e passa o texto; a tabela filtra todas as colunas, ignorando caixa e acento. | string | sem padrão |
isError0.4.0 | boolean | sem padrão |
isFetchingHa uma busca correndo, inclusive a que revalida o dado que ja esta na tela - o `isFetching` do TanStack Query. | boolean | sem padrão |
isLoading0.4.0 | boolean | sem padrão |
isRefetchErrorA ultima busca falhou, mas o dado anterior continua valido - o `isRefetchError` do TanStack Query. | boolean | sem padrão |
labelsOs textos da peca, para trocar o idioma: `retry` e o botao que executa o `onRetry` - a mesma chave em todas as pecas que resolvem os quatro finais -, `selectAll` e `selectRow` os nomes das caixas de marcar, `range` a contagem do rodape da paginacao e `pagination` os textos do `Pagination` de dentro, com as chaves dele; `pagination.navigation` vence o nome derivado do `caption`. | Partial<DataTableLabels> | sem padrão |
maxHeight0.5.0Altura maxima da tabela. | string | number | sem padrão |
noResultsMessageA linha discreta de quando a busca nao acha nada. | ReactNode | "Nenhum resultado para a busca." |
onPaginationChangeChamado quando a pessoa troca de pagina pelo rodape, ou quando a ordem muda. | ((pagination: DataTablePagination) => void) | sem padrão |
onRetry0.4.0Sem isto, o erro nao oferece nova tentativa. | (() => void) | sem padrão |
onRowClick0.4.0Abre a linha no clique, no Enter e no Espaco. | ((row: Row) => void) | sem padrão |
onSortingChangeChamado quando a pessoa troca a ordem pelo cabecalho: crescente, decrescente e `null`, nessa volta. | ((sorting: DataTableSorting | null) => void) | sem padrão |
onValueChange | ((keys: string[]) => void) | sem padrão |
pageSize0.4.0Liga a paginacao, com rodape: contagem a esquerda, paginas a direita. | number | sem padrão |
paginationA pagina e o tamanho de agora, quando quem usa os controla. | DataTablePagination | sem padrão |
rowCountO total de linhas no servidor, e o que liga o modo servidor: o `data` e mostrado como veio, sem ordenar, filtrar nem paginar por conta da tabela. | number | sem padrão |
rowHeight0.5.0A altura de uma linha, em pixel, quando `virtual` esta ligado. | number | 44 |
selectable0.4.0Coluna de checkbox a esquerda. | boolean | sem padrão |
skeletonRows0.4.0Quantas linhas falsas o carregando mostra. | number | 5 |
sortingA ordem de agora, quando quem usa a controla - `null` e sem ordem. | DataTableSorting | null | sem padrão |
valueAs chaves marcadas, quando quem usa controla a selecao. | string[] | sem padrão |
virtual0.5.0Desenha so as linhas que cabem na moldura, e o caminho do meio aparece: cem mil linhas com `sortable` e `filter` continuando a funcionar, sem mandar a pessoa para a paginacao no servidor. | boolean | sem padrão |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.