Ir para o conteúdo principal
WBC - GovBR-DS
Copiar página como Markdown para IA

Card

Componente estável e recomendada para novos projetos.
Anatomia, uso, comportamento visual e recomendações conceituais são mantidos pelo Padrão Digital de Governo. Esta página documenta a implementação Web Components e sua API executável.

Visão Geral​

O br-card agrupa conteúdos sobre um mesmo assunto em um bloco destacado, como um serviço, uma notícia ou um resultado de busca.

Organize o conteúdo nos slots media, header, content e footer, ou coloque tudo no slot padrão.

<br-card>
<img slot="media" src="/imagens/servico.jpg" alt="" />
<h3 slot="header">Carteira de Trabalho Digital</h3>
<p slot="content">Consulte seus vínculos de emprego.</p>
<br-button slot="footer" emphasis="secondary">Acessar</br-button>
</br-card>

Use interactive quando o card inteiro for clicável, para dar o retorno visual ao passar o mouse.

Quando usar​

  • Blocos independentes exibidos em grade ou lista.
  • Conteúdo que combina imagem, título, texto e ações.

Quando evitar​

  • Dados para comparar em linhas e colunas: use br-table.
  • Uma lista simples de textos ou links: use br-list.

Consulte as diretrizes de design do GovBR.

Exemplo(s)​

Desktop (100%)
Tablet - 768px
iPhone (iOS) - 390x844
Android - 360x800
Compartilhar URL
Ativar movimento reduzido
Mudar fundo
Abrir no StackBlitz
Mais opções
Tela cheia
Carregando preview…
HTML
Controles do componente
Console: logs, eventos e erros
Angular (Somente leitura)
React (Somente leitura)
Vue (Somente leitura)
Acessibilidade
Recolher controles e código
Desfazer alteração
Refazer alteração
Comparar alterações
Formatar código
Resetar código para o estado inicial
Escolher formato para copiar

Propriedades​

customId​

Atributocustom-id
DescriçãoIdentificador único do componente.
Quando omitido, um valor é gerado automaticamente.

> Padrão: valor único gerado por generateUniqueId().
Tipostring
Valor padrãogenerateUniqueId()

disabled​

Atributodisabled
DescriçãoDesabilita a interação com o componente.
Tipoboolean
Valor padrãofalse

hover Componente mantido por compatibilidade; prefira a alternativa indicada na documentação.​

Atributohover
DepreciaçãoUse interactive.
DescriçãoDefine se o card tem hover interativo.
Quando true, o card terá efeitos visuais ao passar o mouse.
Tipoboolean
Valor padrãofalse

interactive​

Atributointeractive
DescriçãoHabilita indicação visual de interatividade. Quando informada, tem precedência sobre hover.
Tipoboolean
Valor padrão---

Slots​

NomeDescrição
"content"Slot para o corpo principal do card ao usar a estrutura de slots.
"default"Slot para conteúdo livre do card, quando não usar a estrutura de slots nomeados.
"footer"Slot para o conteúdo do rodapé do card.
"header"Slot para o conteúdo do cabeçalho do card.
"media"Slot para conteúdo de mídia exibido antes do cabeçalho.

CSS Shadow Parts​

NomeDescrição
"content"Área do conteúdo principal.
"footer"Área do rodapé.
"header"Área do cabeçalho.
"media"Área de mídia do card.
"wrapper"Área principal do card.

Dependências​

Usado por​

Gráfico​

Migração de <br-card> (1.x → 2.x)​

Os subcomponentes da 1.x viraram slots.

1.x2.xO que fazer
br-card-contentslot="content"Mova o conteúdo principal para um elemento com esse slot.
br-card-footerslot="footer"Mova o rodapé para um elemento com esse slot.
br-card-headerslot="header"Mova o conteúdo para um elemento com esse slot.
disableddisabledMantenha.
h-fixed—Remova e defina a altura no seu layout.
v-tooltipbr-tooltipUse o componente de tooltip.

1.x:

<br-card>
<br-card-header>Título</br-card-header>
<br-card-content>Conteúdo</br-card-content>
</br-card>

2.x:

<br-card>
<h3 slot="header">Título</h3>
<p slot="content">Conteúdo</p>
</br-card>
Comece aquiComponentesQuickstartsSobre o projetoRepositório GitLabVersõesDiscordGovBR-DSFAQWikiRedefinir cookies