We want to hear from you!Take our 2021 Community Survey!
This site is no longer updated.Go to react.dev

Uncontrolled Component

These docs are old and won’t be updated. Go to react.dev for the new React docs.

These new documentation pages teach modern React and include live examples:

Pada sebagian besar kasus, kami sarankan untuk menggunakan controlled component untuk mengimpementasikan form. Pada controlled component, data form ditangani oleh komponen React. Cara alternatifnya adalah menggunakan uncontrolled component, di mana data form akan ditangani oleh DOM-nya sendiri.

Untuk menulis uncontrolled component, alih-alih menulis event handler untuk setiap pembaruan state, Anda bisa menggunakan ref untuk mendapatkan nilai form dari DOM.

Misalnya, kode berikut menerima sebuah nama dari sebuah uncontrolled component:

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

  handleSubmit(event) {
    alert('Sebuah nama telah dikirim: ' + this.input.current.value);    event.preventDefault();
  }

  render() {
    return (
      <form onSubmit={this.handleSubmit}>
        <label>
          Nama:
          <input type="text" ref={this.input} />        </label>
        <input type="submit" value="Kirim" />
      </form>
    );
  }
}

Coba di CodePen

Oleh karena uncontrolled component menyimpan sumber kebenaran dalam DOM, terkadang lebih mudah untuk mengintegrasikan kode React dan non-React jika menggunakan uncontrolled component. Ini juga berarti lebih sedikit kode jika Anda menginginkan solusi cepat walau tak rapi. Selain itu pada umumnya Anda harus menggunakan controlled component.

Jika masih belum jelas jenis komponen mana yang harus Anda gunakan untuk situasi tertentu, mungkin artikel tentang controlled input versus uncontrolled input bisa membantu.

Nilai Default

Pada lifecycle rendering React, atribut value pada elemen form akan menimpa nilai pada DOM. Dengan uncontrolled component, sering kali Anda menginginkan React untuk menentukan nilai awal tetapi pembaruan berikutnya dilakukan secara uncontrolled. Untuk menangani kasus ini, Anda bisa menentukan atribut defaultValue alih-alih menggunakan 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>
        Nama:
        <input
          defaultValue="Budi"          type="text"
          ref={this.input} />
      </label>
      <input type="submit" value="Kirim" />
    </form>
  );
}

Ini juga berlaku pada dukungan defaultChecked untuk <input type="checkbox"> dan <input type="radio">, serta dukungan defaultValue untuk <select> dan <textarea>.

Tag file input

Pada HTML, sebuah <input type="file"> memungkinkan pengguna untuk memilih satu atau beberapa flle dari media penyimpanan mereka untuk diunggah ke server atau dimanipulasi dengan JavaScript lewat File API.

<input type="file" />

Dalam React, sebuah <input type="file" /> selalu merupakan uncontrolled component karena nilainya hanya bisa disetel oleh pengguna, bukan oleh kode program.

Anda harus menggunakan File API untuk berinteraksi dengan berkas. Contoh berikut menunjukkan cara membuat ref ke simpul DOM untuk mengakses berkas dalam submit handler:

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 />);

Coba di CodePen

Is this page useful?Edit halaman ini