Pular para o conteúdo
Estrutura

Card

/componentes/card.mdmarkdown cru, para quem lê com agent em vez de olho

Completo

Resumo do mês

Agosto de 2026

Doze pedidos de férias aprovados, três aguardando o gestor e nenhum vencido.

Elevações

Plano

Sobre o fundo da página

A superfície padrão, para conteúdo em lista.

Levantado

Com sombra

Para o que precisa saltar do resto da tela.

Título no nível da seção

Painel do mês

Matrículas novas

Outubro de 2026

Quarenta e duas, três a mais que em setembro.

Mensalidades a receber

Vencem nos próximos 30 dias

Sete cobranças, duas delas já vencidas.

Com ação no cabeçalho

Pedidos de outubro

Doze enviados, três aguardando estoque

R$ 48.200,00 vendidos no mês.
Importar
import { Card } from '@rivocode/ui'

Quando usar

Superfície que agrupa conteúdo relacionado.

Compõe com CardHeader, CardTitle, CardDescription, CardAction, CardContent e CardFooter. O título sai como <h3>, então respeita a hierarquia da página. O menu de "⋯" ou o selo no canto do cartão é o CardAction, dentro do CardHeader: ele vai para o alto à direita sem você montar a grade.

elevation="flat" (padrão) fica sobre o fundo. raised ganha sombra, para o que precisa saltar. Não empilhe elevações: se tudo salta, nada salta.

Quando não usar

Para separar blocos só pelo vão, sem moldura, use Stack: um cartão em volta de cada coisa vira uma página de caixas, e a moldura deixa de dizer "isto é um grupo". Linha de lista, com mídia, texto e ação, é Item; e uma pilha de cartões que se comparam campo a campo pede DataTable.

Número de painel com variação é Stat, que já vem com a hierarquia de rótulo, valor e tendência. E aviso que fica na tela é Alert, que traz o tom e o ícone que um cartão não tem.

No React Native

Traduz: o @rivocode/ui-native exporta Card - com CardHeader, CardTitle, CardDescription, CardAction (à direita do título, alinhado ao topo), CardContent e CardFooter, todas com className; o CardTitle se anuncia como cabeçalho e aceita numberOfLines, e não há elevation. A API não é a mesma do web (no nativo tudo é controlado), e a tabela de paridade diz o que muda peça a peça.

API

PropTipo
elevation0.4.0"flat""raised"null

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

Partes

Card se monta com estas peças. Todas vivem nesta página, porque separar cada uma num endereço obrigaria a abrir seis abas para montar uma tela.

CardAction

/card-action.md

O canto de ação do cabeçalho do cartão: o menu de "⋯", um selo de situação, um botão pequeno que vale para o cartão inteiro.

<CardHeader>
  <CardTitle>Pedidos de outubro</CardTitle>
  <CardDescription>Doze enviados, três aguardando estoque</CardDescription>
  <CardAction>
    <Badge tone="warning">3 pendentes</Badge>
  </CardAction>
</CardHeader>

Dentro de um CardHeader, ele vai para o alto à direita e ocupa a altura do título e da descrição, que continuam empilhados à esquerda e quebram linha antes de passar por baixo dele. A ordem no código não importa: o cabeçalho reconhece a parte, e não a posição. Fora de um CardHeader ele é só uma linha com os itens lado a lado.

O menu de "⋯" é um IconButton dentro de um MenuTrigger, como no exemplo "Com ação no cabeçalho" da página do Card. O botão sem texto precisa de nome que diga de qual cartão ele é ("Ações dos pedidos de outubro", e não "Mais"): numa página com seis cartões, seis botões "Mais" seguidos não dizem nada para quem navega pela lista de botões.

Quando não usar

A ação principal do cartão, a que tem texto e é o próximo passo ("Ver detalhes", "Enviar"), mora no CardFooter, onde a leitura termina. O canto é para o secundário. E título de página com ações à direita é PageHeader, e não um cartão em volta do topo da página.

Sem prop própria: repassa ao elemento de baixo o que você mandar.

CardContent

/card-content.md

O corpo do cartão.

Tem respiro próprio nas laterais, então não precisa de outro padding por fora. Vários seguidos empilham sem grudar.

Sem prop própria: repassa ao elemento de baixo o que você mandar.

CardDescription

/card-description.md

A linha de apoio abaixo do título, em texto suave e menor.

Para o que ajuda a decidir se vale ler o cartão, não para o conteúdo dele.

Sem prop própria: repassa ao elemento de baixo o que você mandar.

CardFooter

/card-footer.md

O rodapé do cartão, separado por uma linha.

É onde a ação mora. Alinha em linha com respiro entre os itens; para jogar os botões à direita, use justify-end na className.

Sem prop própria: repassa ao elemento de baixo o que você mandar.

CardHeader

/card-header.md

O topo do cartão: título, descrição e o que mais identifique o conteúdo.

Empilha em coluna com respiro menor embaixo, para o CardContent continuar a leitura sem um vão no meio.

Com um CardAction dentro, vira duas colunas: o título e a descrição à esquerda, e a ação no alto à direita.

Sem prop própria: repassa ao elemento de baixo o que você mandar.

O nome do cartão, na fonte de display.

Sai como <h3>. Se o cartão viver dentro de uma seção com outro nível de heading, troque a tag com render em vez de deixar a ordem quebrada. O caso mais comum é o painel: os cartões vêm logo abaixo do h1 da página, e pular para h3 reprova a ordem de títulos do Lighthouse e do axe.

<Card>
  <CardHeader>
    <CardTitle render={<h2 />}>Sobra ao longo do ano</CardTitle>
  </CardHeader>
</Card>
PropTipo
render

Troca o nivel do heading mantendo o desenho: `render={<h2 />}` quando o cartao vem logo abaixo do `h1` da pagina.

ReactElement<unknown, string | JSXElementConstructor<any>>

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.