Неконтрольовані компоненти

У більшості ситуацій, ми рекомендуємо використовувати контрольовані компоненти для реалізації форм. У контрольованому компоненті, дані форми котролюються React-компонентом. Альтернативним підходом є використання неконтрольованих компонентів, де дані форми контрольюються самим DOM.

Замість того, щоб писати обробник подій для кожного оновлення стану, ви можете використати некотрольований компонент та отримувати значення з DOM через реф.

Наприклад, код нижче отримує ім’я з неконтрольованого компонента:

class NameForm extends React.Component {
  constructor(props) {
    super(props);
    this.handleSubmit = this.handleSubmit.bind(this);
    this.input = React.createRef();  }

  handleSubmit(event) {
    alert("Ім'я, що було надіслано: " + this.input.current.value);    event.preventDefault();
  }

  render() {
    return (
      <form onSubmit={this.handleSubmit}>
        <label>
          Ім'я:
          <input type="text" ref={this.input} />        </label>
        <input type="submit" value="Надіслати" />
      </form>
    );
  }
}

Спробувати на CodePen

Оскільки неконтрольовані компоненти спираються на DOM як на джерело даних, часом використання неконтрольованих компонентів дозволяє простіше інтегрувати React з кодом, що пов’язаний з React. Даний підхід може потребувати менше коду, якщо ви хочете отримати швидкий результати за рахунок “брудного” коду. Тому зазвичай ми наполягаємо на використанні контрольованих компонентів.

Якщо досі не зрозуміло, який тип компонентів використовувати в тій чи іншій ситуацій, можливо стаття про порівняння контрольованих та неконтрольованих полів введення буде для вас корисною.

Значення за замовчуванням

Під час рендерингу значення атрибуту value на елементі форми буде переписувати значення, що визначено в DOM. При використанні неконтрольованих компонентів часом необхідно, щоб React встановив початкове значення, але надалі не контролював оновлення значення. У даному випадку необхідно встановити атрибут defaultValue замість value. Changing the value of defaultValue attribute after a component has mounted will not cause any update of the value in the DOM.

render() {
  return (
    <form onSubmit={this.handleSubmit}>
      <label>
        Ім'я:
        <input
          defaultValue="Іван"          type="text"
          ref={this.input} />
      </label>
      <input type="submit" value="Надіслати" />
    </form>
  );
}

Аналогічно, <input type="checkbox"> та <input type="radio"> підтримують defaultChecked, <select> та <textarea> — defaultValue.

Тег поля завантаження файла

HTML-тег <input type="file"> дає можливість користувачу вибрати один чи декілька файлів зі свого дискового сховища, щоб завантажити їх на сервер, або керувати ними за допомогою JavaScript через File API.

<input type="file" />

У React <input type="file" /> завжди є неконтрольованим компонентом тому, що його значення може бути встановлено тільки користувачем, а не програмним шляхом.

Для взаємодії з файлами ви маєте використувати File API. Наступний приклад демонструє як додати реф до DOM-вузла, щоб отримати доступ до файла під час обробки відправлення форми:

class FileInput extends React.Component {
  constructor(props) {
    super(props);
    this.handleSubmit = this.handleSubmit.bind(this);
    this.fileInput = React.createRef();  }
  handleSubmit(event) {
    event.preventDefault();
    alert(
      `Selected file - ${this.fileInput.current.files[0].name}`    );
  }

  render() {
    return (
      <form onSubmit={this.handleSubmit}>
        <label>
          Upload file:
          <input type="file" ref={this.fileInput} />        </label>
        <br />
        <button type="submit">Submit</button>
      </form>
    );
  }
}

const root = ReactDOM.createRoot(
  document.getElementById('root')
);
root.render(<FileInput />);

Try it on CodePen