Ir para o conteúdo
DevFlash

Júnior

Formulário de cadastro com erros acessíveis

Valide no envio, ligue cada erro ao seu campo e leve o foco para onde a pessoa precisa corrigir.

GrátisJúnior~30 min

Este desafio está em revisão editorial.

Por que cai em entrevista

Formulário é onde o front-end encontra o usuário real, e muita etapa de take-home ou live coding inclui um. Mostrar uma mensagem vermelha é a parte fácil; garantir que qualquer pessoa encontre e corrija o erro é o que vale nota.

Você vai ligar cada mensagem ao campo com aria-describedby, marcar o campo inválido, impedir o envio com erro e levar o foco ao primeiro campo que precisa de correção, tudo em React puro, sem biblioteca de formulário.

O que você vai construir

  1. Campos com rótulo "Email" e "Password" e um botão de envio "Create account".
  2. E-mail vazio mostra "Email is required"; e-mail sem usuário, @ e domínio mostra "Enter a valid email".
  3. Senha com menos de 8 caracteres mostra "Password must be at least 8 characters".
  4. Campo inválido tem aria-invalid="true" e aria-describedby apontando para o erro dele.
  5. Com erro, onSubmit não é chamado e o foco vai para o primeiro campo inválido.
  6. Se estiver válido, onSubmit é chamado uma vez com o e-mail sem espaços nas pontas e a senha como foi digitada.

Fora do escopo: Validar enquanto digita. Biblioteca de formulário. React puro basta aqui.

Como você será avaliado

Passar nos testes é o começo. Na conversa depois, 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.

Código inicial

/src/SignupForm.tsx

type Values = { email: string; password: string };
export function SignupForm({ onSubmit }: { onSubmit: (values: Values) => void }) {
// implemente aqui
return (
<form>
<label htmlFor="email">Email</label>
<input id="email" type="email" />
<label htmlFor="password">Password</label>
<input id="password" type="password" />
<button type="submit">Create account</button>
</form>
);
}
Ver os testes que vão rodar /src/SignupForm.test.tsx
import "@testing-library/jest-dom";
import { render, screen, fireEvent } from "@testing-library/react";
import { SignupForm } from "./SignupForm";
const email = () => screen.getByLabelText("Email");
const password = () => screen.getByLabelText("Password");
const fill = (field: HTMLElement, value: string) => fireEvent.change(field, { target: { value } });
const submit = () => fireEvent.click(screen.getByRole("button", { name: "Create account" }));
describe("SignupForm", () => {
it("submits once with the trimmed email", () => {
const onSubmit = jest.fn();
render(<SignupForm onSubmit={onSubmit} />);
fill(email(), " [email protected] ");
fill(password(), "12345678");
submit();
expect(onSubmit).toHaveBeenCalledTimes(1);
expect(onSubmit).toHaveBeenCalledWith({ email: "[email protected]", password: "12345678" });
});
it("does not submit when the fields are empty", () => {
const onSubmit = jest.fn();
render(<SignupForm onSubmit={onSubmit} />);
submit();
expect(onSubmit).not.toHaveBeenCalled();
expect(screen.getByText("Email is required")).toBeInTheDocument();
expect(screen.getByText("Password must be at least 8 characters")).toBeInTheDocument();
});
it("rejects an email without a domain", () => {
render(<SignupForm onSubmit={jest.fn()} />);
fill(email(), "ana@");
submit();
expect(screen.getByText("Enter a valid email")).toBeInTheDocument();
});
it("links each error to its field", () => {
render(<SignupForm onSubmit={jest.fn()} />);
submit();
expect(email()).toHaveAttribute("aria-invalid", "true");
const errorId = email().getAttribute("aria-describedby") ?? "";
expect(document.getElementById(errorId)).toHaveTextContent("Email is required");
});
it("moves focus to the first invalid field", () => {
render(<SignupForm onSubmit={jest.fn()} />);
fill(email(), "[email protected]");
fill(password(), "short");
submit();
expect(password()).toHaveFocus();
});
it("clears an error once the field is fixed", () => {
const onSubmit = jest.fn();
render(<SignupForm onSubmit={onSubmit} />);
submit();
fill(email(), "[email protected]");
fill(password(), "12345678");
submit();
expect(screen.queryByText("Email is required")).not.toBeInTheDocument();
expect(email()).toHaveAttribute("aria-invalid", "false");
expect(onSubmit).toHaveBeenCalledTimes(1);
});
});

Dicas

Abra só se travar. Cada uma entrega um pouco mais.

Dica 1

Escreva validate(values) como função pura que devolve um objeto de erros. O render e o foco leem dele.

Dica 2

noValidate no form desliga os balões do navegador, então só as suas mensagens aparecem.

Referências