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