Card
Completo
Resumo do mês
Agosto de 2026
Elevações
Plano
Sobre o fundo da página
Levantado
Com sombra
Título no nível da seção
Painel do mês
Matrículas novas
Outubro de 2026
Mensalidades a receber
Vencem nos próximos 30 dias
Com ação no cabeçalho
Pedidos de outubro
Doze enviados, três aguardando estoque
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
| Prop | Tipo |
|---|---|
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.mdO 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.mdO 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.mdA 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.mdO 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.mdO 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.
CardTitle
/card-title.mdO 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>
| Prop | Tipo |
|---|---|
renderTroca 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.