Sign-in
| Versões do DS | V3 |
| Papel (role) | button |
| Elemento HTML | <button> |
| Classe / componente | br-signin |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds.
Nome acessível
O texto do botão ("Entrar com gov.br"). Na variante só com ícone, aria-label com o assunto a que o ícone se refere. Exemplo: Entrar com gov.br.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, botão{estado}
Estados
Desabilitado
- No código:
disabled - Acrescenta ao anúncio: indisponível
Usuário autenticado (variação com nome)
- No código:
texto com o nome da pessoa; menu com aria-expanded se houver - Acrescenta ao anúncio: {nome}, botão
Teclado
| Tecla | O que faz |
|---|---|
| Enter | Ativa o controle em foco |
| Espaço | Ativa botões e alterna controles |
| Tab / Shift+Tab | Move o foco para o controle seguinte / anterior |
Para o desenvolvimento
br-signin (V3). Regra do core: o Signin icônico precisa de aria-label="nome descritivo do assunto a que se refere o ícone" e aria-hidden="true" no ícone. Mantenha o rótulo visível no nome acessível (WCAG 2.5.3).
Fontes
- DS gov.br V3 · @govbr-ds/core — Signin (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Button Pattern
- WCAG · WCAG 2.2 — 2.5.3 Rótulo no nome
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.