Jamdesk Documentation logo

Tabelas

Organize dados em linhas e colunas. Oferece suporte a tabelas Markdown e componentes Table com ordenação, realce e mesclagem.

As tabelas organizam dados em linhas e colunas. O Jamdesk oferece duas abordagens: tabelas Markdown para tabelas rápidas e simples e componentes Table para recursos avançados, como realce e alinhamento.

Uso

<Table>
  <Row header>
    <Cell>Name</Cell>
    <Cell>Type</Cell>
  </Row>
  <Row>
    <Cell>id</Cell>
    <Cell>string</Cell>
  </Row>
</Table>

Tabelas Markdown

A maneira mais rápida de criar uma tabela. Use barras verticais (|) para separar colunas e hífens (-) para a linha de cabeçalho:

| Name | Type | Description |
|------|------|-------------|
| id | string | Unique identifier |
| email | string | User email address |
NomeTipoDescrição
idstringIdentificador exclusivo
emailstringEndereço de e-mail do usuário

As tabelas Markdown são ideais para dados de referência simples. O componente Table oferece mais controle quando você precisa de realce, alinhamento ou destaque visual.

Componente Table

Para ter mais controle, use os componentes <Table>, <Row> e <Cell>:

<Table>
  <Row header>
    <Cell>Name</Cell>
    <Cell>Type</Cell>
    <Cell>Description</Cell>
  </Row>
  <Row>
    <Cell>id</Cell>
    <Cell>string</Cell>
    <Cell>Unique identifier</Cell>
  </Row>
  <Row>
    <Cell>email</Cell>
    <Cell>string</Cell>
    <Cell>User email address</Cell>
  </Row>
</Table>
NomeTipoDescrição
idstringIdentificador exclusivo
emailstringEndereço de e-mail do usuário

Linhas listradas

Adicione fundos alternados às linhas para melhorar a legibilidade:

<Table striped>
  <Row header>
    <Cell>Parameter</Cell>
    <Cell>Value</Cell>
  </Row>
  <Row><Cell>timeout</Cell><Cell>30s</Cell></Row>
  <Row><Cell>retries</Cell><Cell>3</Cell></Row>
  <Row><Cell>backoff</Cell><Cell>exponential</Cell></Row>
  <Row><Cell>maxDelay</Cell><Cell>60s</Cell></Row>
</Table>
ParâmetroValor
timeout30s
retries3
backoffexponencial
maxDelay60s

Com bordas e compacto

Adicione bordas entre as células e reduza o espaçamento interno:

<Table bordered compact>
  <Row header>
    <Cell>A</Cell>
    <Cell>B</Cell>
    <Cell>C</Cell>
  </Row>
  <Row>
    <Cell>1</Cell>
    <Cell>2</Cell>
    <Cell>3</Cell>
  </Row>
</Table>
ABC
123

Realce de linhas

Realce linhas inteiras para chamar a atenção:

<Table>
  <Row header>
    <Cell>Field</Cell>
    <Cell>Required</Cell>
    <Cell>Description</Cell>
  </Row>
  <Row highlight highlightColor="warning">
    <Cell>api_key</Cell>
    <Cell>Yes</Cell>
    <Cell>Your API authentication key</Cell>
  </Row>
  <Row>
    <Cell>limit</Cell>
    <Cell>No</Cell>
    <Cell>Maximum results (default: 100)</Cell>
  </Row>
</Table>
CampoObrigatórioDescrição
api_keySimSua chave de autenticação da API
limitNãoMáximo de resultados (padrão: 100)

Cores de realce disponíveis: primary, success, warning, error, info

Realce de células

Realce células individuais para indicar status:

<Table>
  <Row header>
    <Cell>Service</Cell>
    <Cell>Status</Cell>
  </Row>
  <Row>
    <Cell>API</Cell>
    <Cell highlight highlightColor="success">Operational</Cell>
  </Row>
  <Row>
    <Cell>Database</Cell>
    <Cell highlight highlightColor="warning">Degraded</Cell>
  </Row>
  <Row>
    <Cell>Storage</Cell>
    <Cell highlight highlightColor="error">Outage</Cell>
  </Row>
</Table>
ServiçoStatus
APIOperacional
Banco de dadosDegradado
ArmazenamentoIndisponível

Alinhamento de células

Controle o alinhamento do texto por célula:

<Table>
  <Row header>
    <Cell align="left">Left</Cell>
    <Cell align="center">Center</Cell>
    <Cell align="right">Right</Cell>
  </Row>
  <Row>
    <Cell align="left">Text</Cell>
    <Cell align="center">Text</Cell>
    <Cell align="right">$99.99</Cell>
  </Row>
</Table>
EsquerdaCentroDireita
TextoTexto$99.99

Mesclagem de colunas e linhas

Mescle células entre colunas ou linhas:

<Table bordered>
  <Row header>
    <Cell>Category</Cell>
    <Cell>Item</Cell>
    <Cell>Price</Cell>
  </Row>
  <Row>
    <Cell rowSpan={2}>Fruits</Cell>
    <Cell>Apple</Cell>
    <Cell>$1.00</Cell>
  </Row>
  <Row>
    <Cell>Banana</Cell>
    <Cell>$0.50</Cell>
  </Row>
  <Row>
    <Cell colSpan={2}>Subtotal</Cell>
    <Cell>$1.50</Cell>
  </Row>
</Table>
CategoriaItemPreço
FrutasMaçã$1.00
Banana$0.50
Subtotal$1.50

Legenda visível

Mostre uma legenda acessível acima da tabela:

<Table caption="Monthly Revenue by Region" captionVisible>
  <Row header>
    <Cell>Region</Cell>
    <Cell align="right">Revenue</Cell>
  </Row>
  <Row>
    <Cell>North America</Cell>
    <Cell align="right">$1.2M</Cell>
  </Row>
</Table>
Receita mensal por região
RegiãoReceita
América do Norte$1.2M

Colunas classificáveis

Ative a ordenação interativa de colunas com a prop sortable. Os usuários podem clicar nos cabeçalhos das colunas para classificá-las:

<Table sortable>
  <Row header>
    <Cell>Name</Cell>
    <Cell>Price</Cell>
    <Cell>Stock</Cell>
  </Row>
  <Row><Cell>Widget A</Cell><Cell>$29.99</Cell><Cell>150</Cell></Row>
  <Row><Cell>Gadget B</Cell><Cell>$49.99</Cell><Cell>75</Cell></Row>
  <Row><Cell>Tool C</Cell><Cell>$19.99</Cell><Cell>200</Cell></Row>
  <Row><Cell>Device D</Cell><Cell>$99.99</Cell><Cell>25</Cell></Row>
</Table>
NomePreçoEstoque
Widget A$29.99150
Gadget B$49.9975
Tool C$19.99200
Device D$99.9925

Clique uma vez no cabeçalho de uma coluna para ordenar em ordem crescente, novamente para ordem decrescente e uma terceira vez para redefinir. Os números são ordenados numericamente e o texto, alfabeticamente.

A prop sortable funciona com outros recursos, como linhas listradas:

<Table sortable striped>
  <Row header>
    <Cell>Team</Cell>
    <Cell>Wins</Cell>
    <Cell>Losses</Cell>
  </Row>
  <Row><Cell>Eagles</Cell><Cell>12</Cell><Cell>4</Cell></Row>
  <Row><Cell>Bears</Cell><Cell>8</Cell><Cell>8</Cell></Row>
  <Row><Cell>Lions</Cell><Cell>10</Cell><Cell>6</Cell></Row>
</Table>
EquipeVitóriasDerrotas
Eagles124
Bears88
Lions106

Props

Table

PropTipoPadrãoDescrição
stripedbooleanfalseFundos alternados nas linhas
borderedbooleanfalseBordas entre todas as células
compactbooleanfalseEspaçamento interno reduzido nas células
fullWidthbooleantrueA tabela ocupa toda a largura
captionstring-Texto da legenda da tabela
captionVisiblebooleanfalseMostra a legenda visualmente (padrão: apenas para leitores de tela)
stickyHeaderbooleanfalseMantém o cabeçalho visível durante a rolagem
sortablebooleanfalseAtiva a ordenação por clique nos cabeçalhos das colunas

Row

PropTipoPadrãoDescrição
headerbooleanfalseRenderiza como linha de cabeçalho
highlightbooleanfalseRealça a linha
highlightColorstringprimaryCor: primary, success, warning, error, info

Cell

PropTipoPadrãoDescrição
alignstringleftAlinhamento do texto: left, center, right
colSpannumber-Número de colunas a abranger
rowSpannumber-Número de linhas a abranger
highlightbooleanfalseRealça a célula
highlightColorstringprimaryCor: primary, success, warning, error, info
headerbooleanfalseForça o estilo de cabeçalho

O que vem a seguir?

Visão geral dos componentes

Consulte todos os componentes disponíveis

Fundamentos de MDX

Aprenda a usar componentes em MDX