Avançar para o conteúdo
SilktideAjuda

Mensagens de status

O Silktide solicita que você verifique se as mensagens de status — toasts, snackbars, banners de notificação e mensagens de sucesso e erro — estão configuradas para que os as anunciem quando forem exibidas.

Esta é uma : a automação não consegue identificar com confiabilidade quais elementos são superfícies de status (os nomes de classes, os idiomas e a marcação minificada variam indefinidamente), portanto o Silktide gera o prompt em cada página e uma pessoa o confirma.

<!-- Silencioso: os leitores de tela não anunciarão isto quando for exibido -->
<div class="toast">Item added to cart</div>

<!-- Anunciado: role="status" transforma isto em uma região dinâmica -->
<div class="toast" role="status">Item added to cart</div>

Por que isso é importante

As mensagens de status informam o resultado do que o usuário acabou de fazer: "Formulário salvo", "Item adicionado ao carrinho", "3 resultados encontrados", "Algo deu errado". Usuários que enxergam percebem quando elas aparecem; um leitor de tela lê o que está atualmente em foco, e uma mensagem que aparece em outro local da página não informa nada. O usuário envia um formulário e ouve silêncio — não consegue saber se funcionou, falhou ou ainda está carregando.

Marcar a mensagem como uma informa à que ela deve ser anunciada no momento em que aparecer, sem mover o foco do usuário.

O que verificar

  1. Encontre todas as superfícies de status na página (toasts, snackbars, mensagens instantâneas, banners de sucesso/erro inseridos no conteúdo e atualizações da contagem de resultados).
  2. Confirme se cada uma — ou um contêiner permanente no qual ela insere conteúdo — possui role="status", role="alert", role="log" ou aria-live="polite" / aria-live="assertive".
  3. Prefira um contêiner de região dinâmica que exista quando a página for carregada; insira apenas o texto da mensagem em tempo de execução. Regiões dinâmicas criadas no mesmo momento que suas mensagens muitas vezes não são anunciadas.

Se a página não tiver mensagens de status, ou se todas forem anunciadas corretamente, o resultado.

Como corrigir

  1. Adicione uma função de região dinâmica ao contêiner da mensagem:
    • role="status" para atualizações rotineiras, como confirmações e contagens de resultados.
    • role="alert" para mensagens importantes e urgentes, como erros.
  2. Ou use diretamente o atributo : aria-live="polite" (aguarda uma pausa na fala) ou aria-live="assertive" (interrompe imediatamente).

Como o Silktide testa isso

O Silktide não consegue detectar superfícies de status automaticamente com confiabilidade — fazer suposições com base nos nomes de classes cria uma falsa sensação de segurança e não identifica marcações geradas ou em outros idiomas —, portanto esta verificação gera um prompt de revisão por página, descrevendo o que deve ser verificado.

Saiba mais

Última atualização

Esta página foi útil?