Recursos · 89

Mensagens de estado acessíveis: resultado, espera e erro

Comunicar atualizações sem interromper desnecessariamente a tarefa.

Atualizado · 4 min

Sala vazia de operações de inteligência cibernética à noite Ilustração editorial gerada com IA

O que este guia ajuda a alcançar

  • Mapear atualizações
  • Escolher mecanismo adequado
  • Escrever mensagens completas
  • Testar sequência real
  • Proteger o foco
  • Ligar anúncio ao resultado aceite
  • Verificar sentido em cada língua

Verificação rápida

  • Todas as atualizações devem ser anunciadas?
  • role status basta para passar o teste?
  • Uma confirmação deve receber foco?
  • Cancelar impede qualquer anúncio tardio?
  • Zero é um erro?

Método passo a passo

  1. 1

    Mapear atualizações

    Listar pesquisa, gravação, carrinho, espera e erro. O critério WCAG 4.1.3 trata mensagens de estado apresentadas sem receber foco; não exige anunciar todas as alterações da página.

    Resultado: estados e prioridades documentados.

  2. 2

    Escolher mecanismo adequado

    Usar role status para atualizações apropriadas e distinguir avisos urgentes. Não anunciar cada tecla nem transformar todas as mensagens em alarmes.

    Resultado: mecanismo ligado à tarefa.

  3. 3

    Escrever mensagens completas

    Indicar resultado, objeto e contexto: um número isolado não chega. Tornar recuperável informação útil; preservar erros e valores necessários à correção.

    Resultado: textos e regras de persistência.

  4. 4

    Testar sequência real

    Preparar a região antes da atualização quando necessário. Verificar mensagens repetidas, respostas fora de ordem e combinações reais de navegador e leitor de ecrã. Um papel no DOM não certifica o resultado.

    Resultado: observações de teste reproduzíveis.

  5. 5

    Proteger o foco

    Uma confirmação não deve deslocar arbitrariamente o foco. Um diálogo que pede uma escolha tem comportamento diferente. Testar continuação da tarefa e recuperação após erro.

    Resultado: percurso completo por teclado.

  6. 6

    Ligar anúncio ao resultado aceite

    Associe resposta e operação ativa antes de atualizar resultado ou anúncio. Uma resposta antiga não substitui a atual nem anuncia falso sucesso. Teste navegação, fecho e repetição rápida; cancelar pedido não garante ausência de atualizações antigas.

    Cronologia e anúncios alinhados com resultado visível.

  7. 7

    Verificar sentido em cada língua

    Anuncie frase completa com ação, quantidade e unidade. Teste zero, um, vários, nomes longos e escrita direita-esquerda. Evite fragmentos concatenados com ordem gramatical única. Não leia dados sensíveis desnecessários; indique resultado e recuperação sem toda a entrada.

    Mensagens localizadas e observações com assistência.

Caso de aceitação reproduzível

Exemplo fictício: estes dados não descrevem clientes nem resultados observados.

Ver dados do caso
{
    "action": "save",
    "visual_message": "Saved",
    "programmatic_status": false,
    "focus": "save-button"
}

Decisão esperada

Anuncie a gravação com estado programático sem deslocar desnecessariamente o foco. Repetir uma gravação bem-sucedida seguida de uma falha fictícia. Verificar que o texto anunciado corresponde ao último resultado e não mantém o antigo «guardado» como atual. Testar com tecnologia de apoio; um papel no HTML não prova por si só o resultado percebido.

Variantes fictícias a verificar

Uma confirmação antiga chega após um erro mais recente.

Associe cada resposta à sua ação. Não substitua o último estado útil por uma mensagem de sucesso já desatualizada.

A região de anúncio é criada e preenchida ao mesmo tempo.

Teste o que é realmente anunciado. Prepare uma região adequada antes da atualização; a presença final no HTML não prova o anúncio.

Um erro bloqueia o formulário, mas continua a indicar guardado.

Atualize a mensagem e associe o erro ao respetivo controlo. Verifique separadamente o anúncio e a gestão do foco.

Evidências a conservar

  • Ação, identificador e ordem das respostas.
  • Mensagem anunciada e estado final visível.
  • Foco e resultado com tecnologia de apoio.

Procedimento de verificação

  1. Registe ação, mensagem e foco inicial.
  2. Provoque sucesso e erro com assistência.
  3. Conserve anúncios compreensíveis e posição do foco.
  4. Atrase A e lance B em simulação autorizada; registe resultado e anúncio após cada resposta.
  5. Verifique com assistência escolhida anúncio relevante e foco coerente.
  6. Teste zero, um e vários por língua com unidades e recuperação.

W3C WAI — Understanding SC 4.1.3 Status Messages

Planilha reutilizável

Preencha com suas observações autorizadas. Estes campos são um modelo de trabalho, não resultados observados.

CampoInformações a serem registradas
AtivaçãoAção e evento que altera o estado
AnúncioTexto, prioridade e mecanismo
PersistênciaInformação conservada e recuperação
AceitaçãoTestes com teclado e tecnologias de apoio

Mensagens de estado: gerir respostas tardias e línguas

Exemplo fictício: pesquisa A seguida de B, mas A responde por último. A pessoa deve ler e ouvir o resultado ativo. Uma região live não resolve concorrência; a mensagem segue o estado aceite.

Exemplo prático fictício

Situação ilustrativa

Exemplo fictício: uma pesquisa atualiza apenas um número num canto da página.

Decisão e evidências esperadas

O foco mantém-se no campo; ao concluir aparece uma frase completa com quantidade e contexto, testada com leitor de ecrã.

Distinguir os mecanismos

MecanismoFinalidadeVerificação ou limitação
Texto visualTorna o estado legívelVerificar perceção com tecnologias de apoio
Região de estadoComunica atualizações apropriadasEvitar anúncios repetitivos
DiálogoPede escolha ou interação distintaGerir foco e fecho

Indicadores de gestão

IndicadorO que medePrimeira ação
Estados compreendidosUtilizador identifica resultado e objetoReescrever mensagens ambíguas
Anúncios repetidosRepetições durante uma tarefaReduzir atualizações desnecessárias
Recuperação concluídaCorreção sem perda de dadosPreservar valores e instruções
Anúncios fora de estado ativoMensagens para operações obsoletasRelacionar resposta, estado e anúncio
Variantes compreendidasCasos quantidade-língua compreendidos / casos revistosRegistar navegador e assistência sem generalizar

Erros comuns

  • Verificar perceção com tecnologias de apoio
  • Evitar anúncios repetitivos
  • Gerir foco e fecho

Perguntas frequentes

Todas as atualizações devem ser anunciadas?

Não. Selecionar estados relevantes para a tarefa e evitar ruído contínuo.

role status basta para passar o teste?

Não. Testar texto, sequência, persistência e comportamento real.

Uma confirmação deve receber foco?

Não automaticamente. Preservar contexto quando não é necessária interação distinta.

Cancelar impede qualquer anúncio tardio?

Não. Verifique identidade antes de atualizar. Resultado e anúncio seguem a operação ativa.

Zero é um erro?

Nem sempre. Sem resultados pode ser válido. Explique significado e próxima ação, distinguindo falha técnica.

Referências oficiais

As referências apoiam o método. Adapte as verificações ao seu contexto; elas não são uma certificação. Os títulos das referências originais e os documentos de origem podem estar em outro idioma.

Referências consultadas em .