Ir para o conteúdo
DevFlash
Voltar ao desafio

Solução comentada

Formulário de cadastro com erros acessíveis

Por que funciona

  • A validação é uma função pura, fácil de testar e de reusar no servidor.
  • Os campos são não controlados e lidos por refs no envio; as mesmas refs movem o foco.
  • O aria-describedby só existe enquanto há erro, então o leitor de tela não lê referência vazia.
  • Os erros são recalculados a cada envio, então corrigir um campo apaga a mensagem sem código extra.
/src/SignupForm.tsx
import { useRef, useState, type FormEvent } from "react";
type Values = { email: string; password: string };
type Errors = Partial<Record<keyof Values, string>>;
const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
const MIN_PASSWORD_LENGTH = 8;
function validate({ email, password }: Values): Errors {
const errors: Errors = {};
if (email === "") errors.email = "Email is required";
else if (!EMAIL_PATTERN.test(email)) errors.email = "Enter a valid email";
if (password.length < MIN_PASSWORD_LENGTH) {
errors.password = `Password must be at least ${MIN_PASSWORD_LENGTH} characters`;
}
return errors;
}
export function SignupForm({ onSubmit }: { onSubmit: (values: Values) => void }) {
const [errors, setErrors] = useState<Errors>({});
const emailRef = useRef<HTMLInputElement>(null);
const passwordRef = useRef<HTMLInputElement>(null);
const handleSubmit = (event: FormEvent<HTMLFormElement>) => {
event.preventDefault();
const values = {
email: emailRef.current?.value.trim() ?? "",
password: passwordRef.current?.value ?? "",
};
const found = validate(values);
setErrors(found);
if (found.email) return emailRef.current?.focus();
if (found.password) return passwordRef.current?.focus();
onSubmit(values);
};
return (
<form noValidate onSubmit={handleSubmit}>
<label htmlFor="email">Email</label>
<input
id="email"
ref={emailRef}
type="email"
aria-invalid={Boolean(errors.email)}
aria-describedby={errors.email ? "email-error" : undefined}
/>
{errors.email && <p id="email-error">{errors.email}</p>}
<label htmlFor="password">Password</label>
<input
id="password"
ref={passwordRef}
type="password"
aria-invalid={Boolean(errors.password)}
aria-describedby={errors.password ? "password-error" : undefined}
/>
{errors.password && <p id="password-error">{errors.password}</p>}
<button type="submit">Create account</button>
</form>
);
}

O que uma boa explicação cobre

  • Explica por que o foco vai para o primeiro campo inválido.
  • Diz como os erros chegam à tecnologia assistiva.
  • Justifica campo controlado ou não controlado neste caso.

Fontes