DateTimePicker
Nenhuma fonte cobre tudo deste componente: o ponto em aberto está na seção "Para o desenvolvimento". Se você testou na implementação, conte o que viu nos comentários.
| Versões do DS | V3 |
| Papel (role) | textbox (campo de data) + button (abre o calendário) · dialog e grid no calendário |
| Elemento HTML | <input type="text"> com <label>, <button aria-label="Abrir calendário"> |
| Classe / componente | br-datetimepicker |
| Origem | A documentação do DS não cobre o essencial: completado pela curadoria com o padrão do W3C (WAI-ARIA APG) e o eMAG. |
Documentação oficial: gov.br/ds.
Nome acessível
O rótulo do campo; o formato esperado é informado em texto visível e em aria-description/aria-placeholder (como no core); o botão do calendário leva aria-label. Exemplo: Data de nascimento.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, campo de edição{estado}, formato dia/mês/ano
Estados
Com erro
- No código:
aria-invalid="true" e aria-describedby apontando para a mensagem - Acrescenta ao anúncio: inválido, {mensagem}
Obrigatório
- No código:
required (ou aria-required="true") - Acrescenta ao anúncio: obrigatório
Desabilitado
- No código:
disabled - Acrescenta ao anúncio: indisponível
Calendário aberto
- No código:
role="dialog" aria-label no calendário; foco no dia - Acrescenta ao anúncio: caixa de diálogo, calendário
Teclado
| Tecla | O que faz |
|---|---|
| Setas | No calendário, movem o foco entre os dias |
| Page Up / Page Down | Mês anterior / seguinte |
| Home / End | Início / fim da semana |
| Enter ou Espaço | Escolhe o dia em foco |
| Esc | Fecha o calendário e devolve o foco ao botão |
Para o desenvolvimento
br-datetimepicker (V3). O exemplo do core traz aria-placeholder "dia/mês/ano", aria-description do formato e o botão "Abrir calendário" com ícone aria-hidden. Sempre permita digitar a data. A confirmar: papéis ARIA e teclas do calendário gerado por JavaScript; o código de exemplo não os mostra e as teclas acima vêm do padrão APG de seletor de data.
Fontes
- DS gov.br V3 · @govbr-ds/core — Datetimepicker (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Date Picker Dialog Example
- eMAG 3.1 · eMAG 3.1 — Recomendação 6.5 (fornecer instruções para entrada de dados)
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.