Komponen dan Props

BAB 11: Komponen React

Memahami komponen sebagai unit terkecil UI React, bagaimana mendeklarasikan, menggunakan, dan menyusunnya secara hierarkis.

Di bab-bab sebelumnya, kita sudah banyak menulis JSX (tapi semua kode itu masih hidup di dalam satu blok return di satu tempat. Kondisional, atribut, ekspresi: semuanya berada di satu file yang makin lama makin panjang. Ini sudah cukup untuk contoh kecil, tapi bayangkan membangun aplikasi nyata dengan ratusan bagian UI yang berbeda) semua dalam satu tempat. Aplikasi seperti itu akan sangat sulit dipelihara.

Di sinilah komponen hadir sebagai solusi. Komponen adalah cara React membagi antarmuka menjadi potongan-potongan kecil yang mandiri dan bisa dipakai ulang. Setiap bagian UI (kartu tugas, header, tombol, form) bisa menjadi komponen tersendiri.

Apa Itu Komponen

Komponen React adalah fungsi JavaScript biasa yang mengembalikan JSX. Sesederhana itu. Yang membedakannya dari fungsi biasa adalah konvensi: nama komponen selalu diawali huruf kapital.

Huruf kapital bukan sekadar gaya: React menggunakannya untuk membedakan antara tag HTML bawaan browser dan komponen yang kamu buat sendiri. Ketika React melihat <div>, ia tahu itu elemen HTML. Ketika melihat <KartuTugas>, ia tahu itu komponen yang perlu dirender.

React JSXJSX
// src/components/KartuTugas.jsx

function KartuTugas() {
  return (
    <div className="kartu-tugas">
      <h3>Buat halaman login</h3>
      <span className="badge badge-biru">Aktif</span>
    </div>
  )
}

export default KartuTugas

Komponen di atas adalah fungsi biasa. Ia tidak menerima argumen apapun (untuk saat ini), dan mengembalikan JSX yang sudah kita kenal dari bab-bab sebelumnya. Satu hal baru: export default di baris terakhir, yang memungkinkan file lain menggunakan komponen ini.

Menggunakan Komponen

Setelah komponen dibuat dan diekspor, kamu bisa menggunakannya di mana pun, termasuk di komponen lain. Import dulu, lalu tulis sebagai tag JSX:

React JSXJSX
// src/App.jsx
import KartuTugas from './components/KartuTugas'

function App() {
  return (
    <div className="app">
      <h1>Daftar Tugas</h1>
      <KartuTugas />
    </div>
  )
}

export default App

<KartuTugas /> adalah self-closing tag, sama seperti <img /> atau <br /> di HTML. Kamu juga bisa menulisnya sebagai tag berpasangan <KartuTugas></KartuTugas> jika nanti perlu meletakkan konten di dalamnya, tapi untuk komponen yang tidak butuh children, self-closing lebih ringkas.

Satu komponen bisa dipakai sebanyak apapun:

React JSXJSX
// src/App.jsx
import KartuTugas from './components/KartuTugas'

function App() {
  return (
    <div className="app">
      <h1>Daftar Tugas</h1>
      <KartuTugas />
      <KartuTugas />
      <KartuTugas />
    </div>
  )
}

export default App

Tiga <KartuTugas /> akan merender tiga kartu identik. Tentu ini belum berguna karena semua kartu menampilkan data yang sama, nanti kita akan mengatasi ini dengan props di bab berikutnya.

Komponen di File Terpisah

Memisahkan setiap komponen ke file tersendiri adalah konvensi yang hampir universal di proyek React. Ada beberapa alasan praktisnya: mudah ditemukan saat debugging, mudah diuji secara terisolasi, dan memudahkan kerja tim karena setiap orang bisa mengerjakan komponen berbeda tanpa konflik.

Konvensi penamaan file komponen mengikuti nama komponen itu sendiri: KartuTugas disimpan di KartuTugas.jsx. Huruf kapital di awal nama file bukan keharusan teknis, tapi konvensi yang luas digunakan.

Struktur folder yang umum untuk proyek daftar-tugas yang kita bangun:

CodeTEXT
src/
  components/
    KartuTugas.jsx
    DaftarTugas.jsx
    TombolAksi.jsx
    NotifikasiTugas.jsx
  App.jsx
  main.jsx

Setiap komponen yang sudah kita tulis di bab-bab sebelumnya (KartuTugas, TombolAksi, NotifikasiTugas) masing-masing layak mendapat file tersendiri.

Menyusun Komponen

Kekuatan sebenarnya dari komponen muncul ketika kamu mulai menyusunnya, menempatkan komponen di dalam komponen lain. Ini disebut komposisi komponen, dan ini adalah cara React membangun antarmuka yang kompleks dari bagian-bagian yang sederhana.

Bayangkan tampilan aplikasi daftar-tugas kita:

CodeTEXT
App
  └── DaftarTugas
        ├── KartuTugas
        │     └── TombolAksi
        └── KartuTugas
              └── TombolAksi

Setiap node di diagram ini adalah komponen. App merender DaftarTugas, yang merender beberapa KartuTugas, yang masing-masing berisi TombolAksi. Hierarki ini disebut component tree.

CodeIMAGE
A clean technical diagram showing a React component tree hierarchy. At the top, a blue rectangle labeled "App". Below it, connected by an arrow, an orange rectangle labeled "DaftarTugas". Below DaftarTugas, two blue rectangles labeled "KartuTugas" side by side, each connected by arrows from DaftarTugas. Below each KartuTugas, a green rectangle labeled "TombolAksi". All connections shown as thin gray arrows pointing downward. White background, flat design, sans-serif font, 16:9 aspect ratio. All text labels in Indonesian.

Mari kita implementasikan struktur ini. Mulai dari TombolAksi:

React JSXJSX
// src/components/TombolAksi.jsx

function TombolAksi() {
  return (
    <button className="tombol-aksi">
      Tandai Selesai
    </button>
  )
}

export default TombolAksi

Lalu KartuTugas yang menggunakan TombolAksi:

React JSXJSX
// src/components/KartuTugas.jsx
import TombolAksi from './TombolAksi'

function KartuTugas() {
  return (
    <div className="kartu-tugas">
      <h3>Buat halaman login</h3>
      <span className="badge badge-biru">Aktif</span>
      <TombolAksi />
    </div>
  )
}

export default KartuTugas

Lalu DaftarTugas yang menggunakan KartuTugas:

React JSXJSX
// src/components/DaftarTugas.jsx
import KartuTugas from './KartuTugas'

function DaftarTugas() {
  return (
    <div className="daftar-tugas">
      <KartuTugas />
      <KartuTugas />
    </div>
  )
}

export default DaftarTugas

Dan App sebagai puncak hierarki:

React JSXJSX
// src/App.jsx
import DaftarTugas from './components/DaftarTugas'

function App() {
  return (
    <div className="app">
      <h1>Daftar Tugas</h1>
      <DaftarTugas />
    </div>
  )
}

export default App

Perhatikan pola yang muncul: setiap komponen hanya tahu satu hal. TombolAksi hanya tahu cara merender tombol. KartuTugas hanya tahu cara merender satu kartu. DaftarTugas hanya tahu cara menyusun beberapa kartu. Ini adalah prinsip single responsibility: setiap komponen bertanggung jawab atas satu bagian UI.

Satu File, Beberapa Komponen

Ada satu kasus di mana menempatkan beberapa komponen dalam satu file masuk akal: ketika sebuah komponen kecil hanya digunakan oleh satu komponen lain dan tidak perlu dipakai di tempat lain. Komponen seperti ini sering disebut subcomponen atau helper component.

React JSXJSX
// src/components/KartuTugas.jsx

// BadgePrioritas hanya digunakan oleh KartuTugas
// tidak perlu file tersendiri
function BadgePrioritas({ level }) {
  if (level === 'tinggi') return <span className="badge badge-merah">Tinggi</span>
  if (level === 'mendesak') return <span className="badge badge-oranye">Mendesak</span>
  return <span className="badge badge-biru">Normal</span>
}

function KartuTugas() {
  return (
    <div className="kartu-tugas">
      <h3>Buat halaman login</h3>
      <BadgePrioritas level="tinggi" />
    </div>
  )
}

export default KartuTugas

BadgePrioritas tidak diekspor, ia private untuk file ini. Begitu komponen helper mulai dibutuhkan di tempat lain, saatnya dipindahkan ke file tersendiri.

Gunakan aturan sederhana ini: jika komponen dipakai di lebih dari satu tempat, berikan file tersendiri. Jika hanya dipakai di satu komponen, boleh tetap di file yang sama.

Hindari Komponen di Dalam Komponen

Satu hal yang harus dihindari adalah mendefinisikan komponen di dalam komponen lain:

React JSXJSX
// JANGAN lakukan ini
function DaftarTugas() {
  // KartuTugas didefinisikan ulang setiap DaftarTugas render
  function KartuTugas() {
    return <div>Kartu Tugas</div>
  }

  return (
    <div>
      <KartuTugas />
    </div>
  )
}

Setiap kali DaftarTugas dirender, React akan membuat fungsi KartuTugas baru. Dari perspektif React, ini adalah komponen yang berbeda dari render sebelumnya, sehingga React akan unmount dan remount komponen itu alih-alih memperbaruinya. Ini merusak performa dan bisa menyebabkan bug yang sulit dilacak.

Selalu definisikan komponen di level modul, bukan di dalam komponen lain.

Mendefinisikan komponen di dalam komponen lain menyebabkan React menganggapnya sebagai komponen baru di setiap render. State di dalamnya akan hilang, dan React akan melakukan remount yang tidak perlu.

Latihan

Buka proyek daftar-tugas yang sudah kita kerjakan sepanjang ebook ini:

  1. Buat komponen HeaderAplikasi yang merender judul "Daftar Tugas" dan sebuah tombol "Tambah Tugas". Simpan di src/components/HeaderAplikasi.jsx dan gunakan di App.jsx.

  2. Ekstrak BadgePrioritas dari KartuTugas.jsx menjadi file tersendiri di src/components/BadgePrioritas.jsx. Pastikan KartuTugas masih berfungsi setelah ekstraksi.

  3. Buat komponen RingkasanTugas yang merender dua <span>: satu menampilkan teks "Total: 5 tugas" dan satu lagi "Selesai: 2 tugas". Nilai masih hardcoded untuk sekarang, kita akan membuatnya dinamis setelah belajar props.

Penutup

Komponen adalah inti dari cara React berpikir. Bukan sekadar teknik pemrograman, ini adalah cara memecah masalah yang kompleks menjadi bagian-bagian yang bisa dikelola. Satu komponen, satu tanggung jawab; banyak komponen disusun, antarmuka yang utuh.

Tapi ada satu hal yang belum bisa dilakukan komponen kita: berbicara satu sama lain. Semua kartu tugas kita masih menampilkan data yang sama persis karena kita belum punya cara untuk mengirim data berbeda ke setiap komponen. Itulah yang akan kita pelajari di bab berikutnya, props, mekanisme yang memungkinkan komponen induk mengirim data ke komponen anaknya.

Referensi

  1. 1 Your First Component: React Documentation
  2. 2 Importing and Exporting Components: React Documentation