BAB 13: Props
Kirim data dari komponen induk ke komponen anak menggunakan props, antarmuka utama komunikasi antar komponen di React.
Di bab sebelumnya, kita melihat sekilas this.props di class component (cara React meneruskan data dari komponen induk ke anak. Tapi kita belum benar-benar menyelami mekanismenya. Komponen yang sudah kita buat sejauh ini) KartuTugas, DaftarTugas, masih menggunakan data yang ditulis langsung di dalam komponen itu sendiri. Itu artinya satu komponen hanya bisa menampilkan satu data. Bagaimana kalau kita ingin satu komponen yang sama menampilkan tugas yang berbeda-beda?
Di sinilah props bekerja. Props adalah mekanisme yang memungkinkan komponen menerima data dari luar, seperti parameter fungsi, tapi untuk komponen. Dengan props, satu komponen bisa menampilkan ratusan variasi data yang berbeda, semuanya dari satu definisi komponen yang sama.
Props Sebagai Argumen Komponen
Cara termudah memahami props: komponen adalah fungsi, dan props adalah argumennya.
Ketika kamu menulis function KartuTugas() tanpa parameter, komponen itu selalu menghasilkan tampilan yang sama. Tapi begitu kamu tambahkan parameter props, komponen bisa menerima data dari luar:
// src/components/KartuTugas.jsx
function KartuTugas(props) {
return (
<div className="kartu-tugas">
<h3>{props.judul}</h3>
<span className="badge">{props.status}</span>
</div>
)
}
export default KartuTugas
Untuk menggunakan komponen ini, kamu kirim data sebagai atribut JSX, persis seperti atribut HTML:
// src/App.jsx
import KartuTugas from './components/KartuTugas'
function App() {
return (
<div className="papan-tugas">
<KartuTugas judul="Buat halaman login" status="Aktif" />
<KartuTugas judul="Review pull request" status="Selesai" />
<KartuTugas judul="Update dokumentasi" status="Aktif" />
</div>
)
}
export default App
Tiga komponen KartuTugas, satu definisi. Masing-masing menampilkan data yang berbeda karena menerima props yang berbeda. Inilah kekuatan reusability yang selama ini menjadi alasan utama menggunakan React.
Tipe Data yang Bisa Dikirim lewat Props
Props tidak terbatas pada string. Kamu bisa mengirim hampir semua tipe data JavaScript, angka, boolean, objek, array, bahkan fungsi.
Aturannya sederhana: string dikirim dengan tanda kutip biasa, semua tipe lain menggunakan kurung kurawal {}:
// src/App.jsx (dikembangkan dari sebelumnya)
import KartuTugas from './components/KartuTugas'
function App() {
const tugasUrgent = {
judul: "Deploy ke production",
status: "Urgent",
prioritas: 1
}
return (
<div className="papan-tugas">
{/* string, pakai tanda kutip */}
<KartuTugas judul="Buat halaman login" status="Aktif" />
{/* angka, pakai kurung kurawal */}
<KartuTugas judul="Review pull request" status="Selesai" nomor={2} />
{/* boolean, pakai kurung kurawal */}
<KartuTugas judul="Update dokumentasi" status="Aktif" terlambat={true} />
{/* objek, pakai kurung kurawal */}
<KartuTugas info={tugasUrgent} />
</div>
)
}
export default App
Di sisi komponen penerima, akses nilai-nilainya melalui objek props:
// src/components/KartuTugas.jsx (dikembangkan)
function KartuTugas(props) {
return (
<div className={`kartu-tugas ${props.terlambat ? 'terlambat' : ''}`}>
<span className="nomor-urut">#{props.nomor}</span>
<h3>{props.judul}</h3>
<span className="badge">{props.status}</span>
</div>
)
}
export default KartuTugas
Mengirim Objek sebagai Props
Ketika data yang perlu dikirim sudah terkumpul dalam satu objek, kamu bisa mengirim objeknya secara langsung, atau menyebarnya menggunakan spread operator.
Cara pertama, kirim objek sebagai satu props:
// src/App.jsx
const dataTugas = {
judul: "Deploy ke production",
status: "Urgent",
tenggat: "2026-03-20"
}
// kirim sebagai satu props
<KartuTugas info={dataTugas} />
Akses di komponen menggunakan dot notation:
// src/components/KartuTugas.jsx
function KartuTugas(props) {
return (
<div className="kartu-tugas">
<h3>{props.info.judul}</h3>
<span>{props.info.status}</span>
<small>Tenggat: {props.info.tenggat}</small>
</div>
)
}
Cara kedua, sebarkan properti objek langsung menjadi props tersendiri menggunakan spread:
// src/App.jsx
const dataTugas = {
judul: "Deploy ke production",
status: "Urgent",
tenggat: "2026-03-20"
}
// spread: setiap key jadi props tersendiri
<KartuTugas {...dataTugas} />
Hasilnya setara dengan menulis <KartuTugas judul="Deploy ke production" status="Urgent" tenggat="2026-03-20" /> secara manual. Komponen bisa langsung mengakses props.judul, props.status, dan props.tenggat tanpa lapisan .info.
Pilih cara mana yang lebih sesuai dengan struktur data kamu. Jika objek memang mewakili satu "entitas" yang utuh (misal: satu tugas), kirim sebagai satu props objek agar komponen tahu data ini saling berkaitan. Spread lebih cocok ketika kamu ingin komponen menerima props yang flat dan independen.
Mengirim Array lewat Props
Array dikirim dengan cara yang sama, menggunakan kurung kurawal:
// src/App.jsx
const labelTugas = ["bug", "frontend", "high-priority"]
<KartuTugas
judul="Perbaiki bug login"
status="Aktif"
label={labelTugas}
/>
Di komponen penerima, render array dengan .map() seperti biasa:
// src/components/KartuTugas.jsx (dikembangkan)
function KartuTugas(props) {
return (
<div className="kartu-tugas">
<h3>{props.judul}</h3>
<span className="badge">{props.status}</span>
<div className="label-container">
{props.label.map((item, index) => (
<span key={index} className="label">
{item}
</span>
))}
</div>
</div>
)
}
export default KartuTugas
Props Bersifat Read-Only
Satu hal yang perlu dipahami dengan baik: props tidak bisa diubah dari dalam komponen yang menerimanya. Props mengalir satu arah (dari induk ke anak) dan komponen anak tidak punya hak untuk memutasi nilainya.
Jika kamu mencoba melakukan ini:
// SALAH: jangan lakukan ini
function KartuTugas(props) {
props.judul = "Judul baru" // ini akan error
// ...
}
React akan melempar error. Ini disengaja, immutability props adalah pondasi yang membuat alur data React mudah diprediksi. Jika ada data yang perlu berubah, data itu harus hidup di state, bukan di props.
Jika kamu perlu memodifikasi data yang datang dari props, buat salinan lokal menggunakan variabel biasa, bukan dengan mengubah props secara langsung. Contoh: const judulDiformat = props.judul.toUpperCase(), aman, karena kamu tidak menyentuh props.
Alur Data Searah
Props mendorong pola yang disebut one-way data flow: data mengalir dari atas ke bawah dalam pohon komponen.

App mengirim data ke KartuTugas, dan KartuTugas bisa meneruskan sebagian data itu ke BadgeStatus. Data tidak bisa bergerak ke atas: BadgeStatus tidak bisa mengirim data ke KartuTugas melalui props. Pola ini membuat debugging lebih mudah karena kamu selalu tahu dari mana data berasal.
Latihan
Proyek daftar-tugas kita sudah punya KartuTugas yang menerima beberapa props. Kembangkan lebih lanjut:
-
Buat komponen
ProfilAnggotayang menerima propsnama(string),peran(string), danaktif(boolean). Tampilkan nama dan peran, dan ubah warna teks menjadi abu-abu jikaaktifbernilaifalse. -
Buat array objek yang berisi minimal 4 tugas (masing-masing punya
id,judul,status, danlabelberupa array string). Render seluruh tugas menggunakan.map()diApp.jsx, kirim setiap tugas keKartuTugasmenggunakan spread operator. -
Buat komponen
RingkasanProyekyang menerima propsnamProyek(string) dandaftarTugas(array objek tugas). Di dalam komponen, hitung berapa banyak tugas berstatus "Aktif" dan tampilkan ringkasannya, tanpa mengubah array yang dikirim sebagai props.
Penutup
Props adalah sistem komunikasi satu arah yang menjadi tulang punggung bagaimana komponen React saling bertukar data. Dengan props, satu komponen bisa menampilkan ribuan variasi tampilan dari satu definisi kode yang sama.
Tapi kamu mungkin sudah merasakan sebuah keterbatasan: props hanya bisa mengirim data dari atas ke bawah. Bagaimana kalau KartuTugas perlu memberi tahu App bahwa sebuah tugas telah diselesaikan? Atau bagaimana kalau kita perlu mengakses props.judul tanpa harus selalu menuliskan props. setiap saat? Di bab berikutnya, kita akan belajar props destructuring: cara menyederhanakan akses props yang hampir selalu digunakan di kode React modern.