Pular para o conteúdo principal

Card

Versões do DSV3 e V4
Papel (role)sem papel próprio (contêiner); o conteúdo mantém a semântica: heading, link, button, img
Elemento HTML<div> ou <article> com título (h2–h6) e, se clicável, um <a>/<button> no título
Classe / componentebr-card
OrigemVeio da documentação do DS gov.br, completada onde faltava.

Documentação oficial: gov.br/ds · next-ds.

Nome acessível​

O título do card. Se o card inteiro é clicável, o link do título cobre a área; evite role="button" no contêiner. Exemplo: Carteira de trabalho digital.

O que é anunciado​

Esperado conforme o padrão (WAI-ARIA APG): {nome}, título nível {nivel} · {nome}, link{estado}

Comportamento esperado, não a fala exata: NVDA, JAWS, VoiceOver e TalkBack variam. No plugin, cada elemento tem um campo para o resultado do teste com leitor de tela real.

Estados​

Desabilitado​

  • No código: aria-disabled="true" no card e nos controles internos (como no exemplo do core)
  • Acrescenta ao anúncio: indisponível

Expandido / recolhido​

  • No código: aria-expanded="true|false" no botão que revela o conteúdo, com aria-controls
  • Acrescenta ao anúncio: expandido / recolhido

Teclado​

TeclaO que faz
TabNavega para o elemento interativo seguinte
Shift+TabNavega para o elemento interativo anterior
EnterAtiva o link ou ação quando aplicável
EspaçoAtiva o Button quando aplicável
Fonte: documentação do DS gov.br (V4).

Para o desenvolvimento​

br-card (V3) / <br-card> (V4). Card só informativo não recebe foco. Imagem informativa com alt; decorativa com alt="". Botões de ícone do card com aria-label.

Fontes​

Comentários e evolução

Viu algo a corrigir ou completar nesta especificação? Comente abaixo dizendo qual parte, o que mudar e a fonte (WCAG, eMAG, WAI-ARIA APG, documentação do DS gov.br ou teste com leitor de tela). É preciso uma conta no GitHub. As sugestões aceitas entram na base e aparecem nas Novidades.