Pesquisar
Introduza pelo menos dois caracteres, sem dados pessoais.

    BibliotecaArtigos e FAQs Seu projetoSolicite um orçamento
    LínguaPT ▾
    Guias práticos

    Escreva erros de formulário que ajudam as pessoas a se recuperarem

    Um erro ajuda apenas quando alguém sabe o que falhou e pode ser retomado sem inserir tudo novamente.

    Veja o método

    Ilustração — Escreva erros de formulário que ajudam as pessoas a se recuperarem
    Ilustração gerada por IA

    Descreva a correção esperada

    Conecte cada mensagem ao seu campo e explique as informações necessárias. “Endereço de e-mail incompleto” ajuda mais do que um código técnico. Não culpe o usuário por uma interrupção do servidor ou serviço indisponível.

    Explique as regras antes da entrada sempre que possível: formato, comprimento, arquivos aceitos e informações opcionais. Os Guia de formulário de contato Ajuda a reduzir os campos e esclarecer as expectativas.

    O momento do controlo faz parte da mensagem. Um campo obrigatório vazio à abertura não deve ser anunciado como errado antes de uma tentativa de envio. Ao escrever um endereço, um valor provisório como alex@ não exige necessariamente um alerta por tecla. Conforme a tarefa, valide ao sair do campo ou depois de submeter; o retorno imediato pode ser útil para verificar disponibilidade remotamente.

    aria-invalid indica que um valor falhou a validação; não define regras nem bloqueia sozinho o envio. Associe o estado a uma explicação de correção e reavalie depois. Um formato de email aceite não prova que o endereço é alcançável. Verificação pendente e falha do serviço exigem mensagens próprias.

    • campo e problema identificável.
    • Ação de correção explícita.
    • Restrições explicadas cedo.

    Desloque a tabela horizontalmente para ler todas as colunas. Com o teclado, coloque o foco na tabela e utilize as teclas de seta.

    Exercício fictício: escolher quando anunciar um erro
    Momento observadoRetorno adequado ao casoControlo a efetuar
    Primeira abertura, campo obrigatório vazioRótulo, indicação obrigatória e ajudaSem aria-invalid="true" prematuro
    Endereço ainda em escritaDeixar concluir segundo a estratégia escolhidaEvitar alertas repetidos para um estado provisório
    Tentativa de envio com valor rejeitadoErro explícito associado ao campoaria-invalid, mensagem acessível e correção possível

    Torne o feedback perceptível

    Após o envio, mostre um resumo próximo ao início e uma mensagem ao lado de cada campo afetado. Mova o foco de forma previsível e conecte cada campo ao seu erro de tecnologia assistiva. A cor por si só é insuficiente.

    Os Tutorial de notificação W3C Dá exemplos de feedback local e geral. Teste o teclado, o leitor de tela, o zoom e as telas estreitas.

    Exemplo fictício: um formulário tem nome, endereço de correio eletrónico e mensagem. Falta o nome e o endereço está incompleto; a mensagem já é válida. A primeira verificação deve indicar 2 erros, não 3. Corrigir apenas o nome deixa 1 erro; corrigir também o endereço não deixa nenhum. Compare em cada passo o resumo, os erros junto dos campos e os valores conservados, sem obrigar a escrever novamente a mensagem.

    Neste contrato de teste, cada ligação do resumo conduz ao campo afetado; aria-describedby associa a explicação ao controlo e aria-invalid indica o estado inválido. Após a correção, retire a associação ao erro ultrapassado, mantendo as instruções úteis. Uma falha do serviço depois da validação não é outro erro de preenchimento nem prova qualquer registo. A tabela distingue assim 0 erros de campo de um envio realmente confirmado.

    • Mensagens de resumo e campo.
    • associações de erros acessíveis.
    • Foco e contraste testados.

    Desloque a tabela horizontalmente para ler todas as colunas. Com o teclado, coloque o foco na tabela e utilize as teclas de seta.

    Corrigir progressivamente dois erros: teste fictício
    Passo do testeErros de campo restantesResultado esperado
    Primeira verificação2: nome e correio eletrónicoMensagem conservada; ambos os erros acessíveis
    Apenas nome corrigido1: correio eletrónicoErro do nome retirado; o outro mantém-se
    Endereço também corrigido0Campos válidos; registo ainda por verificar
    Serviço indisponível após validação0; incidente de serviço separadoSem falsa confirmação; recuperação explicada
    • W3C WAI : User Notification

      W3C WAI, consultado em 22 de outubro de 2026: notificações de formulários. Os campos e passos são um exemplo pedagógico fictício.

    preservar a entrada e a intenção

    Mantenha valores válidos após um erro, exceto dados confidenciais que não devem ser exibidos novamente. Um formulário longo deve permitir que alguém seja retomado. Um arquivo rejeitado precisa de uma explicação de formato ou tamanho.

    Distinguir erros de validação, atrasos na rede e envio duplicado. Cliques repetidos não devem criar várias solicitações ou pedidos. A confirmação deve dizer se a ação foi realmente registrada.

    • Campos válidos retidos.
    • Falhas de rede tratadas com clareza.
    • Submissões duplicadas controladas.

    Teste casos reais

    Experimente campos vazios, personagens acentuados, e-mail digitado incorretamente, arquivo de grandes dimensões, sessão expirada e servidor indisponível. Peça a alguém que não esteja familiarizado com o formulário para se recuperar sem ajuda e observe a hesitação.

    Após a correção, verifique o e-mail ou a próxima etapa, não apenas a mensagem na tela. O conteúdo de confirmação e erro também precisa ser revisado em todos os idiomas publicados.

    • Erros representativos abordados.
    • viagem completa verificada.
    • Mensagens traduzidas e revisadas.

    Corrigir um campo sem perder os restantes

    Caneta, formulário vazio e grelha de calendário numa mesa
    Ilustração gerada por IA · Corrija um campo sem apagar os dados já introduzidos.

    Caso proposto: uma data inválida apaga outros campos. A pessoa precisa de reconstruir o pedido.

    Teste erros e novas tentativas com dados fictícios. Verifique valores preservados, mensagens associadas aos campos e correção compreensível.

    • Provocar um erro conhecido
    • Verificar valores preservados
    • Repetir o pedido

    Documentos de referência

    Conteúdo atualizado

    Referências documentadas para este tema

    Referências documentadas para este tema
    ReferênciaValor ou sintaxeÂmbito
    WCAG 2.2 · 1.4.10
    320 CSS pxConteúdo vertical sem deslocamento em duas dimensões; exceções para conteúdos necessariamente bidimensionais.
    WCAG 2.2 · 2.5.8
    24 × 24 CSS pxUm alvo menor pode cumprir o critério através do espaçamento; existem outras exceções.
    WCAG 2.2 · 3.3.7
    A · same processNo mesmo processo, os dados já fornecidos devem ser preenchidos automaticamente ou estar disponíveis para seleção, salvo as exceções do critério. O preenchimento do navegador não basta; o site deve disponibilizar os dados recebidos ou evitar pedi-los novamente.

    As datas indicam a consulta das fontes. Estes dados não constituem uma auditoria do site nem uma declaração global de conformidade.

    Matriz de validação funcional para se adaptar ao projeto

    Esses controles propostos usam casos fictícios. Decida qual comportamento é esperado com a equipe, anote o resultado e atribua discrepâncias não resolvidas antes da publicação.

    Desloque a tabela horizontalmente para ler todas as colunas. Com o teclado, coloque o foco na tabela e utilize as teclas de seta.

    Casos de teste, resultados esperados e evidências úteis
    CasoResultado esperadoProva para guardar
    Dois campos são inválidos após o envio.Cada erro está associado ao seu campo e o resumo ajuda a localizá-los.Registre o URL, as etapas, o resultado e as evidências datadas.

    Perguntas frequentes

    Onde devem aparecer os erros de formulário úteis?

    Associe uma mensagem precisa ao seu campo e forneça um resumo para vários erros. Explique a correção sem detalhes internos. Preserve entradas úteis e verifique o teclado e a leitura assistida. A cor por si só não consegue identificar o problema.

    Que mensagem mostrar se o envio falhar com campos válidos?

    Distinguir entrada inválida, serviço indisponível e resultado ainda desconhecido após interrupção. Não pedir a correção de um campo aceite. Guardar valores úteis e explicar a recuperação prevista. Se o servidor puder ter guardado o pedido antes do corte, verificar o resultado segundo o contrato do serviço antes de apresentar um novo envio como isento de efeitos adicionais.