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

Komponen and Props

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:

Komponen mempermudah Anda untuk memecah antarmuka pengguna menjadi bagian tersendiri, bagian yang bisa digunakan kembali, dan berpikir tentang setiap potongan dalam isolasi. Halaman ini memberikan pengantar tentang ide komponen. Anda dapat menemukan rujukan API komponen terperinci di sini

Secara konsep, komponen mirip dengan fungsi pada Javascript. Komponen menerima beberapa masukan (biasa disebut “props”) dan mengembalikan element React yang mendeskripsikan apa yang seharusnya tampil pada layar.

Fungsi dan Komponen Kelas

Cara paling sederhana untuk mendefinisikan sebuah komponen adalah dengan menuliskan sebuah fungsi Javascript:

function Welcome(props) {
  return <h1>Halo, {props.name}</h1>;
}

Fungsi ini adalah komponen React yang sah karena menerima sebuah “props” tunggal (yang bertindak sebagai props) atau argumen objek dengan data dan kembalian sebuah elemen React. Kita menyebut komponen karena itu benar-benar merupakan fungsi Javascript.

Anda juga dapat menggunakan sebuah ES6 class untuk mendefinisikan sebuah komponen:

class Welcome extends React.Component {
  render() {
    return <h1>Halo, {this.props.name}</h1>;
  }
}

Dari sudut pandang React, kedua komponen di atas mempunyai nilai yang sama.

Komponen fungsi dan kelas mempunyai beberapa fitur tambahan yang akan kita diskusikan di bagian selanjutnya.

Merender sebuah Komponen

Sebelumnya, kita hanya menemui elemen React yang mewakili tag DOM:

const element = <div />;

Namun, elemen juga dapat mewakilkan komponen yang didefinisikan oleh pengguna:

const element = <Welcome name="Sara" />;

Ketika React melihat sebuah element mewakili sebuah komponen yang dibuat oleh pengguna, komponen mengoper atribut JSX ke dalam komponen ini sebagai obyek tunggal. Kita menyebut obyek ini “props”.

Sebagai contoh, kode ini akan me-render “Halo, Sara” pada laman:

function Welcome(props) {  return <h1>Halo, {props.name}</h1>;
}

const root = ReactDOM.createRoot(document.getElementById('root'));
const element = <Welcome name="Sara" />;root.render(element);

Try it on CodePen

Mari merangkum apa yang terjadi pada contoh berikut:

  1. Kita memanggil root.render() dengan elemen <Welcome name="Sara" />.
  2. React memanggil komponen Welcome dengan {name: 'Sara'} sebagai propertinya.
  3. Komponen Welcome kita akan mengembalikan sebuah element <h1>Halo, Sara</h1 sebagai hasilnya.
  4. React DOM dengan efisien akan memperbarui DOM yang sesuai <h1>Halo, Sara.

Catatan: Selalu awali nama komponen dengan sebuah huruf kapital.

React memperlakukan awalan komponen dengan huruf kecil sebagai tag dari DOM. Sebagai contoh, <div />, merepresentasikan sebuah HTML div tag, tetapi <Welcome /> merepresentasikan sebuah komponen dan membutuhkan Welcome to be in scope.

Anda dapat membaca lebih lanjut tentang alasan dibalik Konvensi tersebut di sini.

Menyusun Komponen

Komponen dapat merujuk ke komponen lain pada keluaran mereka. Ini memungkinkan kita untuk menggunakan abstraksi dari komponen yang sama untuk semua tingkat detail. Sebuah tombol, sebuah form, sebuah dialog, sebuah tampilan: di dalam aplikasi React, semua itu dinyatakan dalam bentuk komponen.

Sebagai contoh, kita dapat membuat sebuah komponen App yang mencetak Welcome berkali-kali.

function Welcome(props) {
  return <h1>Halo, {props.name}</h1>;
}

function App() {
  return (
    <div>
      <Welcome name="Sara" />      <Welcome name="Cahal" />      <Welcome name="Edite" />    </div>
  );
}

Try it on CodePen

Secara khusus, aplikasi React yang baru mempunyai sebuah komponen App pada bagian paling atas. Namun, jika Anda mengintegrasi React kedalam aplikasi yang ada, Anda mungkin akan memulai secara bottom-up dengan komponen yang kecil seperti Button dan secara bertahap kedalam hierarki paling atas.

Mengekstraksi Komponen

Jangan ragu untuk memisahkan komponen ke dalam bentuk yang lebih kecil.

Sebagai contoh, pertimbangkan komponen Comment berikut ini:

function Comment(props) {
  return (
    <div className="Comment">
      <div className="UserInfo">
        <img className="Avatar"
          src={props.author.avatarUrl}
          alt={props.author.name}
        />
        <div className="UserInfo-name">
          {props.author.name}
        </div>
      </div>
      <div className="Comment-text">
        {props.text}
      </div>
      <div className="Comment-date">
        {formatDate(props.date)}
      </div>
    </div>
  );
}

Try it on CodePen

Komponen menerima author (sebuah objek), text (sebuah string), dan date (sebuah tanggal) sebagai props, dan mendeskripsikan sebuah komponen dalam situs media sosial.

Komponen ini sedikit rumit untuk diganti karena semua berada dalam sarang, dan itu juga sulit untuk digunakan kembali sebagai komponen pribadi. Mari mengekstraksi beberapa komponen darinya:

Pertama, kita akan mengekstraksi Avatar:

function Avatar(props) {
  return (
    <img className="Avatar"      src={props.user.avatarUrl}      alt={props.user.name}    />  );
}

Avatar tidak perlu tahu bahwa komponen ini di render di dalam sebuah Comment. Ini mengapa kita harus memberikan props yang lebih umum seperti: user daripada author.

Kami merekomendasikan penamaan props melalui sudut pandang komponen itu sendiri daripada konteks bagaimana komponen tersebut digunakan.

Kita sekarang dapat sedikit menyederhanakan Comment:

function Comment(props) {
  return (
    <div className="Comment">
      <div className="UserInfo">
        <Avatar user={props.author} />        <div className="UserInfo-name">
          {props.author.name}
        </div>
      </div>
      <div className="Comment-text">
        {props.text}
      </div>
      <div className="Comment-date">
        {formatDate(props.date)}
      </div>
    </div>
  );
}

Selanjutnya, kita akan mengekstraksi sebuah komponen UserInfo yang me-render sebuah komponen Avatar di sebelah nama pengguna:

function UserInfo(props) {
  return (
    <div className="UserInfo">      <Avatar user={props.user} />      <div className="UserInfo-name">        {props.user.name}      </div>    </div>  );
}

Ini memungkinkan kita untuk menyederhanakan Comment lebih jauh:

function Comment(props) {
  return (
    <div className="Comment">
      <UserInfo user={props.author} />      <div className="Comment-text">
        {props.text}
      </div>
      <div className="Comment-date">
        {formatDate(props.date)}
      </div>
    </div>
  );
}

Try it on CodePen

Mengekstraksi komponen mungkin terlihat seperti pekerjaan yang kasar pada awalnya, namun mempunyai pallete dari komponen yang bisa digunakan kembali akan terbayar pada aplikasi yang lebih besar. Aturan praktik yang bagus adalah jika pada bagian dari antarmuka pengguna digunakan beberapa kali (Button, Panel, Avatar), atau yang cukup kompleks (App, FeedStory, Comment), ini merupakan kandidat yang bagus untuk dijadikan sebagai komponen yang dapat digunakan kembali.

Props bersifat Read-Only

Apakah Anda mendeklarasikan sebuah komponen sebagai sebuah fungsi atau sebuah kelas, jangan pernah mengganti propertinya sendiri. Pertimbangkan fungsi sum ini:

function sum(a, b) {
  return a + b;
}

Fungsi seperti itu disebut pure karena mereka tidak mencoba untuk mengganti masukan mereka dan selalu mengembalikan hasil yang sama untuk setiap masukan yang sama.

Sebaliknya, fungsi dibawah bukan merupakan fungsi yang murni karena hal itu telah mengubah masukannya:

function withdraw(account, amount) {
  account.total -= amount;
}

React sangat fleksibel namun memiliki suatu peraturan yang ketat:

Semua komponen React harus bertindak seperti fungsi yang murni sehubungan dengan properti mereka.

Tentu saja, antarmuka pengguna dari aplikasi akan dinamis dan selalu berganti. Di sesi selanjutnya, kita akan memperkenalkan sebuah konsep baru tentang “state”. State memperbolehkan komponen React untuk mengganti keluaran mereka secara berkala untuk merespon aksi dari pengguna, respon dari jaringan, dan yang lainnya, tanpa melanggar aturan.

Is this page useful?Edit halaman ini