re:re:actable
Урок 073 минуты чтения

Ошибки валидации форм

На этой странице
Кратко

Ошибка валидации объясняет, какое поле нужно исправить. Она является ожидаемым результатом пользовательского ввода, а не аварией React-дерева.

Вопрос

Как показывать ошибки формы понятно и доступно?

Основная идея

Сообщение «Неверные данные» заставляет пользователя угадывать причину. Лучше указать конкретное поле и требование: «Введите email в формате name@example.com». Клиентская проверка помогает быстро исправить ввод, серверная защищает данные и проверяет правила, которые неизвестны браузеру.

Обычно первую ошибку показывают после blur или попытки отправки, а после этого обновляют по мере исправления. Для большого количества полей используют touched и errors либо библиотеку форм. Не стоит пересчитывать критичную финальную валидацию только в эффекте: при submit проверяйте актуальные значения непосредственно.

Доступность требует связать поле с текстом ошибки через aria-describedby, отметить aria-invalid и перевести фокус к первому проблемному полю. Общая ошибка сервера располагается отдельно от полевых. Текст должен помогать продолжить действие, а не показывать внутренний стек исключения.

Пример

Пример для клиентского React-приложения с поддержкой JSX. API в примере возвращает JSON; его адрес замените на адрес своего сервера.

import { useRef, useState } from 'react';
 
export default function EmailForm() {
  const inputRef = useRef(null);
  const [email, setEmail] = useState('');
  const [error, setError] = useState('');
  const [saved, setSaved] = useState(false);
  function submit(event) {
    event.preventDefault();
    setSaved(false);
    const message = /^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(email)
      ? '' : 'Введите email в формате name@example.com';
    setError(message);
    if (message) { inputRef.current?.focus(); return; }
    setSaved(true); // Здесь можно вызвать API и обработать серверные ошибки.
  }
  return <form noValidate onSubmit={submit}>
    <label htmlFor="email">Email</label>
    <input id="email" type="email" ref={inputRef} value={email}
      onChange={e => { setEmail(e.target.value); setSaved(false); }}
      aria-invalid={Boolean(error)} aria-describedby={error ? 'email-error' : undefined} />
    {error && <p id="email-error" role="alert">{error}</p>}
    <button>Сохранить</button>
    {saved && <p role="status">Клиентская проверка пройдена</p>}
  </form>;
}

Submit проверяет текущий email. При ошибке фокус возвращается к полю; при успехе демонстрируется только результат клиентской проверки, а не реальное сохранение на сервере.

Клиентские и серверные ошибки формы

Клиентская проверка (мгновенно)        Серверная проверка (после отправки)
├─ пустое поле, формат email           ├─ email уже занят
├─ длина пароля                        ├─ промокод недействителен
└─ совпадение паролей                  └─ товар закончился
          │                                        │
          ▼                                        ▼
  ошибка у поля сразу                  ошибка у поля или общий баннер формы

Сервер — источник правды: клиентскую проверку можно обойти, поэтому все правила повторяются на сервере, а его ответ показывается в тех же местах.

Серверные ошибки через React 19 Actions

import { useActionState } from "react";
 
async function register(_prev, formData) {
  const res = await fetch("/api/register", { method: "POST", body: formData });
  if (res.status === 422) return { fieldErrors: await res.json() }; // { email: "Уже занят" }
  if (!res.ok) return { formError: "Сервис недоступен, попробуйте позже" };
  return { ok: true };
}
 
export function RegisterForm() {
  const [state, action, pending] = useActionState(register, {});
  return (
    <form action={action}>
      {state.formError && <p role="alert">{state.formError}</p>}
      <label htmlFor="reg-email">Email</label>
      <input id="reg-email" name="email" type="email"
        aria-invalid={Boolean(state.fieldErrors?.email)}
        aria-describedby={state.fieldErrors?.email ? "reg-email-error" : undefined} />
      {state.fieldErrors?.email && <p id="reg-email-error">{state.fieldErrors.email}</p>}
      <button disabled={pending}>{pending ? "Отправляем…" : "Зарегистрироваться"}</button>
    </form>
  );
}

Подробно о формах (React Hook Form, Zod, серверные ошибки, доступность) — в теме «16. Формы».

Что важно помнить

  • Регулярное выражение здесь учебное; оно не подтверждает существование адреса.
  • noValidate отключает встроенную браузерную проверку ради демонстрации собственной.
  • Сервер обязан повторно проверить входные данные, даже если клиент уже проверил их.

Мини-шпаргалка

Поле → конкретная ошибка. Общая проблема → баннер. Submit → проверить сейчас. Ошибка → фокус + aria.

Документация

React: input, WAI: уведомления об ошибках форм.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам