ErrorSummary
Resumo de erros de validação no topo do formulário, com links para cada campo (`id` do campo, ou `name` como recuo). A11y: `role="alert"`, foco automático só quando o `focusKey` muda (passe `focusKey={tentativa}`, somado a cada envio inválido; sem `focusKey`, foca ao passar de 0 para N erros). O resumo que some e volta enquanto a pessoa digita não rouba o foco. Título ligado por id gerado. Liste os itens na ordem dos campos na tela; com React Hook Form, use `shouldFocusError: false`. Sem margem externa: espace pelo layout (ex.: `className="mb-6"`).
Quando usar
Sempre que um formulário puder falhar em mais de um campo. Em formulário longo, é o que permite descobrir o que deu errado sem percorrer a página inteira.
Quando não usar
Em formulário de campo único, a mensagem junto ao campo basta — o resumo só acrescenta um passo. Para erro que não é de validação (falha de rede), use Alert.
Acessibilidade
- role="alert" anuncia o bloco assim que ele aparece.
- O resumo recebe o foco — não o primeiro campo. Quem chega ouve quantos erros existem antes de decidir para onde ir.
- Cada item é link para o campo que o causou; o foco vai para o controle mesmo quando o id está no invólucro.
- Erro nunca é sinalizado só por cor: há texto, borda mais espessa e sublinhado no link.
- Resumo vazio não é renderizado (role="alert" sem conteúdo anuncia o nada).
- Atende aos critérios 3.3.1 e 3.3.3 da WCAG (ver padrão de mensagens de erro acessíveis).
id é o do campo. focusKey muda a cada envio inválido e é o único gatilho de foco: o resumo refoca quando a pessoa tenta de novo, mas não quando some e volta enquanto ela digita.
Preview
Variantes e composição
| Prop / grupo | Valores |
|---|---|
props | title · errors [{ id, message }] · autoFocus · focusKey |