Pular para o conteúdo principal

Magic Button

Versões do DSV3
Papel (role)button
Elemento HTML<button>
Classe / componentebr-magicbutton
OrigemVeio da documentação do DS gov.br, completada onde faltava.

Documentação oficial: gov.br/ds.

Nome acessível​

Botão flutuante em geral só com ícone: aria-label com a ação é obrigatório. Exemplo: Adicionar.

O que é anunciado​

Esperado conforme o padrão (WAI-ARIA APG): {nome}, botão{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: disabled
  • Acrescenta ao anúncio: indisponível

Teclado​

TeclaO que faz
EnterAtiva o controle em foco
EspaçoAtiva botões e alterna controles
Tab / Shift+TabMove o foco para o controle seguinte / anterior
Fonte: curadoria (WAI-ARIA APG).

Para o desenvolvimento​

br-magicbutton (V3). Regra do core: aria-label="descrição da ação" nos botões que tenham só ícone; ícone com aria-hidden="true". Posição fixa não pode cobrir conteúdo nem os controles em zoom de 200%.

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.