Pular para o conteúdo principal

DateTimePicker

A confirmar

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 DSV3
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 / componentebr-datetimepicker
OrigemA 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

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​

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​

TeclaO que faz
SetasNo calendário, movem o foco entre os dias
Page Up / Page DownMês anterior / seguinte
Home / EndInício / fim da semana
Enter ou EspaçoEscolhe o dia em foco
EscFecha o calendário e devolve o foco ao botão
Fonte: curadoria (WAI-ARIA APG).

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​

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.