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

Kontrolsüz Bileşenler

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:

Çoğu durumda, formları uygulamak için kontrollü bileşenler kullanmanızı öneririz. Kontrollü bir bileşende, form verileri bir React bileşeni tarafından ele alınır. Alternatifi ise, form verilerinin DOM’ın kendisi tarafından işlendiği kontrolsüz bileşenlerdir.

Bir kontrolsüz bileşen yazmak için, her state güncellemesine bir olay yöneticisi yazmak yerine, form verilerini DOM üzerinden getirmek için ref kullanabilirsiniz.

Örneğin, bu kod kontrolsüz bir bileşende tek bir isim kabul eder:

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

  handleSubmit(event) {
    alert('A name was submitted: ' + this.input.current.value);    event.preventDefault();
  }

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

CodePen’de Deneyin

Kontrolsüz bir bileşen DOM üzerinde gerçeğin kaynağını koruduğundan, kontrolsüz bileşenleri kullanırken React ve React olmayan kodu entegre etmek bazen daha kolaydır. Ayrıca hızlı ve özensiz olmak istiyorsanız bu biraz daha az kod olabilir. Aksi takdirde, genellikle kontrollü bileşenler kullanmalısınız.

Eğer henüz belirli bir durum için hangi bileşen tipini kullanmanız gerektiğini bilmiyorsanız, kontrollü ve kontrolsüz input’lara ilişkin bu makaleyi faydalı bulabilirsiniz.

Varsayılan Değerler

React render etme yaşam döngüsünde, form elemanlarında bulunan value niteliği, DOM içindeki değeri geçersiz kılar. Kontrolsüz bir bileşen ile, React’in başlangıç ​​değerini belirlemesini isteyebilir, ancak sonraki güncellemeleri kontrolsüz bırakmak isteyebilirsiniz. Bu durumda, value yerine defaultValue niteliğini belirtebilirsiniz. defaultValue değerini bileşen yüklendikten sonra değiştirmek, DOM içinde herhangi bir değer değişikliğine sebep olmayacaktır.

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

Aynı şekilde, <input type="checkbox"> ve <input type="radio"> defaultChecked niteliğini destekler, <select> ve <textarea> ise defaultValue niteliğini destekler.

Dosya Girdisi Etiketi

HTML’de, <input type="file"> kullanıcının cihaz belleği üzerinden bir sunucuya yükleneceği veya JavaScript tarafından File API ile değiştirebileceği bir veya daha fazla dosya seçmesini sağlar.

<input type="file" />

React’te, <input type="file" /> her zaman kontrolsüz bir bileşendir, çünkü değeri yalnızca bir kullanıcı tarafından ayarlanabilir, programlanabilir bir biçimde olamaz.

Dosyalarla etkileşimde bulunmak için File API’ını kullanmalısınız. Aşağıdaki örnek, bir gönderme yöneticisi üzerinde bulunan dosyalara erişmek için DOM node’una bir ref’in nasıl oluşturulacağını gösterir:

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

CodePen'de Deneyin

Bu sayfayı yararlı buldun mu?Bu sayfayı düzenle