Card
| Versões do DS | V3 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 / componente | br-card |
| Origem | Veio 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}
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
| Tecla | O que faz |
|---|---|
| Tab | Navega para o elemento interativo seguinte |
| Shift+Tab | Navega para o elemento interativo anterior |
| Enter | Ativa o link ou ação quando aplicável |
| Espaço | Ativa o Button quando aplicável |
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
- DS gov.br V4 · next-ds — Card, acessibilidade
- DS gov.br V3 · @govbr-ds/core — Card (documentação e código de exemplo)
- WCAG · WCAG 2.2 — 1.3.1 Informações e relações
- eMAG 3.1 · eMAG 3.1 — Recomendação 3.6 (alternativa em texto para as imagens do sítio)
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.