Phone icon Связаться с нами

Веб-разработка

Что такое управляемые компоненты в React?

Управляемый компонент (controlled component) — это поле формы в React, значение которого полностью контролирует состояние компонента. Значение передают в поле через атрибут value, а каждое изменение обрабатывают в onChange, обновляя состояние.

Так React становится «единственным источником правды» для данных формы: в любой момент значения доступны в состоянии, их легко проверить, изменить, отформатировать или использовать для блокировки кнопки. Например, можно разрешить вводить только цифры или сразу показывать ошибку валидации.

Противоположный подход — неуправляемые компоненты: поле хранит значение само в DOM, начальное значение задают через defaultValue, а прочитать его можно через ref или FormData при отправке. Такой код короче и работает быстрее на больших формах.

Где применяется

Управляемые поля используют, когда нужна реакция на каждый символ: мгновенная валидация, маски телефона и карты, поиск во время ввода, зависимые поля, счётчики символов, динамические формы с добавлением полей.

Для больших форм часто выбирают библиотеку React Hook Form, которая по умолчанию работает с неуправляемыми полями и минимизирует рендеры. В React 19 формы можно обрабатывать и через действия (actions) и FormData.

Пример

Форма заявки с управляемыми полями и одним обработчиком изменений.

import { useState } from 'react';

function LeadForm() {
  const [form, setForm] = useState({ name: '', phone: '', course: 'react' });

  const handleChange = (e) => {
    const { name, value } = e.target;
    setForm(prev => ({ ...prev, [name]: value }));
  };

  return (
    <form onSubmit={e => { e.preventDefault(); console.log(form); }}>
      <input name="name" value={form.name} onChange={handleChange} />
      <input name="phone" value={form.phone} onChange={handleChange} />
      <select name="course" value={form.course} onChange={handleChange}>
        <option value="react">React</option>
        <option value="java">Java</option>
      </select>
      <button disabled={!form.name || !form.phone}>Send</button>
    </form>
  );
}
Атрибуты value и onChange и состояние в виде объекта.

Управляемые и неуправляемые компоненты: в чём разница

В управляемом компоненте значение хранится в состоянии React и меняется через setState. В неуправляемом значение живёт в DOM, а React лишь читает его, когда нужно. Управляемые дают больше контроля, неуправляемые — более простой код и меньше рендеров.

Частые вопросы

Почему поле не даёт ничего ввести?

Скорее всего, задан value, но нет onChange или состояние не обновляется. Тогда React всегда возвращает то же значение. Для поля только для чтения добавляют атрибут readOnly.

Что означает предупреждение о переходе из неуправляемого в управляемое поле?

Значение сначала было undefined, а затем стало строкой. Начальное значение в состоянии задают пустой строкой, а не undefined.

Как работать с checkbox в управляемом стиле?

Вместо value используют атрибут checked и в onChange читают e.target.checked.

Обучение фронтенд-разработке в OWU

Освойте фронтенд-разработку на практических курсах с менторами и реальными проектами.

Выбрать курс