Pular para o conteúdo

Card

Container de conteúdo para agrupar informação relacionada.

Relatorio mensal

Maio 2026

Pronto

Indicadores consolidados e liberados para revisao.

Instalação

Instale Card da sua stack e rode o comando individual ITpS em seguida. O comando itps add card é theme-only: ele valida o slug e confirma que o contrato visual vem do tema ITpS, das classes copy-first e dos snippets desta página.

terminal · React/Next

pnpm dlx shadcn@latest add card
pnpm dlx github:ITPS/sinapse-ui-cli add card

terminal · Vue3/Nuxt4

pnpm dlx shadcn-vue@latest add card
pnpm dlx github:ITPS/sinapse-ui-cli add card

O comando individual adapta só este componente; não instala o catálogo inteiro.

Uso

Em React/Next com shadcn/ui e Vue3/Nuxt4 com shadcn-vue, use Card e seus compostos para estruturar cabeçalho, conteúdo, ações e rodapé. A composição deixa claro onde ficam título, descrição e ação.

Para HTML ou wrappers finos, use itps-card quando precisar de uma superfície neutra copy-first. Card não cria hierarquia interna; use heading, texto, Tag, Avatar ou Button conforme o conteúdo exigir.

Exemplos

Estrutura

PeçaReact/Next e Vue3/Nuxt4HTML
ContainerCarditps-card
CabeçalhoCardHeaderlayout interno livre
TítuloCardTitleheading sem classe obrigatória
DescriçãoCardDescriptiontexto de apoio
AçãoCardActionButton, Link ou Tag conforme o caso
ConteúdoCardContentcorpo do card
RodapéCardFooterbloco final opcional

Variantes

Use a variante base para superfície com borda. itps-card--elevated adiciona sombra; itps-card--flat remove a borda visual e o padding para encaixar o conteúdo em layouts densos.

Flat
Outline
Elevated

API copy-first

ClasseUso
itps-cardSuperfície base com borda, fundo card e padding.
itps-card--elevatedCard com sombra para destaque moderado.
itps-card--flatRemove borda visual e padding para composição interna.

Acessibilidade

Use <div> para agrupamento visual sem ação. Quando o bloco inteiro precisar navegar, prefira Feature Card ou um Link claro dentro do conteúdo. Evite colocar vários controles primários dentro de um card pequeno; isso torna a varredura e o foco mais difíceis.