BAB 9: Atribut JSX
Cara menulis atribut HTML di JSX (dari className hingga style inline) beserta konvensi camelCase yang membedakannya dari HTML biasa.
Di bab sebelumnya, kita berkenalan dengan kurung kurawal { } sebagai cara menyisipkan ekspresi JavaScript ke dalam JSX, termasuk menggunakannya sebagai nilai atribut seperti src={urlFoto}. Tapi ada lebih banyak hal tentang atribut JSX yang perlu dipahami, terutama perbedaannya dari HTML biasa yang mungkin sudah kamu hafal.
JSX bukan HTML. Ia tampak seperti HTML, tapi di baliknya ia adalah JavaScript. Konsekuensinya, atribut-atribut di JSX mengikuti aturan JavaScript (bukan aturan HTML) dan ini menciptakan sejumlah perbedaan yang perlu kamu kenali agar tidak membuang waktu men-debug masalah yang sebenarnya mudah.
Mengapa Atribut JSX Berbeda dari HTML
Saat JSX dikompilasi, ia berubah menjadi pemanggilan fungsi JavaScript. Artinya, nama-nama atribut menjadi kunci di sebuah objek JavaScript. Dan objek JavaScript punya aturan sendiri: beberapa nama tidak bisa digunakan karena sudah menjadi reserved keyword bahasa, dan penamaan umumnya mengikuti konvensi camelCase.
Itulah sebabnya kamu tidak bisa menulis class="..." di JSX. class adalah kata yang sudah dipakai JavaScript untuk mendefinisikan class. Begitu pula for, ia sudah dipakai untuk loop.
className, Bukan class
Ini adalah perbedaan paling sering ditemui. Di HTML kamu menulis:
<!-- HTML biasa -->
<div class="kartu-tugas aktif">isi kartu</div>
Di JSX, gunakan className:
// src/App.jsx
return (
<div className="kartu-tugas aktif">
<h3>Redesign halaman utama</h3>
</div>
)
React akan mengonversi className menjadi atribut class yang sesungguhnya saat merender ke DOM. Kamu tidak perlu memikirkan ini, cukup ingat bahwa di dalam JSX, selalu pakai className.
Jika kamu menulis class= di JSX, React akan tetap merender halaman tapi menampilkan peringatan di konsol: "Invalid DOM property class. Did you mean className?". Ini tidak akan menyebabkan crash, tapi styling mungkin tidak diterapkan dengan benar di beberapa kasus.
htmlFor pada Label
Pasangan dari className adalah htmlFor. Di HTML, atribut for digunakan di elemen <label> untuk menghubungkannya ke input:
<!-- HTML biasa -->
<label for="judul-tugas">Judul Tugas</label>
<input id="judul-tugas" type="text" />
Di JSX, for diganti dengan htmlFor:
// src/App.jsx
return (
<form>
<label htmlFor="judulTugas">Judul Tugas</label>
<input id="judulTugas" type="text" placeholder="Masukkan judul..." />
</form>
)
Logikanya sama: for adalah reserved word JavaScript (dipakai untuk for loop), jadi perlu nama pengganti.
Konvensi camelCase untuk Semua Atribut
Aturan yang lebih luas: atribut HTML yang mengandung tanda hubung (-) harus ditulis ulang dalam camelCase di JSX. Ini karena tanda hubung tidak valid dalam nama properti objek JavaScript.
Beberapa contoh yang sering ditemui:
| Atribut HTML | Atribut JSX |
|---|---|
class | className |
for | htmlFor |
tabindex | tabIndex |
autofocus | autoFocus |
autocomplete | autoComplete |
spellcheck | spellCheck |
contenteditable | contentEditable |
readonly | readOnly |
maxlength | maxLength |
Kamu tidak perlu menghafal seluruh daftar ini sekarang. Polanya konsisten: pisah kata dengan huruf kapital, bukan tanda hubung. Jika ragu, konverter html-to-jsx bisa membantu mengonversi HTML yang sudah ada.
Pengecualian: aria-* dan data-*
Ada dua kategori atribut yang menjadi pengecualian, mereka tetap menggunakan tanda hubung persis seperti di HTML:
// src/App.jsx
return (
<button
aria-label="Hapus tugas Redesign halaman utama"
aria-pressed={false}
data-tugas-id="tugas-001"
>
Hapus
</button>
)
aria-* adalah atribut aksesibilitas yang didefinisikan oleh spesifikasi WAI-ARIA, dan data-* adalah atribut kustom HTML5. Keduanya dirancang menggunakan tanda hubung sejak awal dan React menghormati konvensi itu.
Style Inline sebagai Objek JavaScript
Di HTML biasa, style menerima string CSS:
<!-- HTML biasa -->
<div style="background-color: #f1f5f9; padding: 16px;">isi</div>
Di JSX, style menerima objek JavaScript: bukan string. Dan properti CSS di dalam objek itu ditulis dalam camelCase:
// src/App.jsx
return (
<div style={{ backgroundColor: '#f1f5f9', padding: '16px' }}>
<h3>Redesign halaman utama</h3>
</div>
)
Dua kurung kurawal di sini bukan sintaks khusus, yang luar adalah ekspresi JSX { }, yang dalam adalah objek JavaScript { }. Kamu sudah melihat pola ini di bab sebelumnya saat membahas style pada bagian double curly braces.
Untuk style yang lebih panjang, simpan dalam variabel agar lebih bersih:
// src/App.jsx
const styleKartuTugas = {
backgroundColor: '#f1f5f9',
padding: '16px',
borderRadius: '8px',
borderLeft: '4px solid #3b82f6'
}
const styleBadgePrioritas = {
fontSize: '12px',
fontWeight: '600',
color: '#dc2626',
backgroundColor: '#fef2f2',
padding: '2px 8px',
borderRadius: '4px'
}
return (
<div style={styleKartuTugas}>
<h3>Redesign halaman utama</h3>
<span style={styleBadgePrioritas}>Tinggi</span>
</div>
)
Untuk nilai yang satuannya px, React menerima angka tanpa string: padding: 16 sama dengan padding: '16px'. Ini berlaku untuk sebagian besar properti numerik, tapi tidak semuanya. Jika ragu, gunakan string eksplisit dengan satuan.
Boolean Attributes
Beberapa atribut HTML bersifat boolean, kehadirannya saja sudah berarti true. Di JSX, kamu bisa menulisnya dengan dua cara:
// src/App.jsx
// Dua cara ini identik:
<input disabled />
<input disabled={true} />
// Untuk menonaktifkan:
<input disabled={false} />
Ketika menuliskan disabled tanpa nilai, JSX mengasumsikan {true}. Ini nyaman untuk kasus statis, tapi saat nilainya dinamis kamu perlu bentuk eksplisit:
// src/App.jsx
const isSimpan = true
return (
<form>
<input
type="text"
placeholder="Judul tugas baru"
disabled={isSimpan}
/>
<button type="submit" disabled={isSimpan}>
{isSimpan ? 'Menyimpan...' : 'Simpan Tugas'}
</button>
</form>
)
Beberapa atribut boolean yang sering dipakai: disabled, checked, required, readOnly, autoFocus, hidden, multiple.
Event Handler dalam camelCase
Atribut event di HTML ditulis lowercase: onclick, onchange, onsubmit. Di JSX, semuanya menggunakan camelCase:
// src/App.jsx
function handleKlikTambah() {
console.log('tombol tambah diklik')
}
return (
<button onClick={handleKlikTambah}>
Tambah Tugas
</button>
)
Perhatikan bahwa nilai event handler dilewatkan sebagai referensi fungsi: {handleKlikTambah}, bukan {handleKlikTambah()}. Memanggil dengan tanda kurung akan mengeksekusi fungsi langsung saat render, bukan saat diklik. Event handling akan dibahas secara mendalam di Bab 16.
Nilai null dan undefined Menghapus Atribut
Satu hal kecil tapi berguna: jika nilai atribut adalah null atau undefined, React tidak akan merender atribut tersebut ke DOM sama sekali:
// src/App.jsx
const linkEksternal = null // tidak ada link
return (
<a href={linkEksternal}> {/* atribut href tidak akan muncul di DOM */}
Detail tugas
</a>
)
Ini berguna untuk kondisi di mana kamu ingin atribut muncul atau tidak berdasarkan data yang tersedia, tanpa perlu operator ternary yang rumit.
Latihan
Buka proyek daftar-tugas yang sudah kita kerjakan, lalu coba latihan berikut:
-
Buat sebuah kartu tugas menggunakan
styleinline dengan objek JavaScript. Kartu harus memiliki warna border kiri yang berbeda berdasarkan prioritas: biru untuk'normal', kuning untuk'mendesak', dan merah untuk'tinggi'. Gunakan operator ternary atau short-circuit&&untuk menentukan warna. -
Buat form sederhana dengan dua field: judul dan deskripsi tugas. Tambahkan
labelyang terhubung ke masing-masing input menggunakanhtmlFordanid. Pastikan atributrequireddanautoFocusjuga terpasang dengan benar di JSX. -
Tambahkan tombol "Simpan" yang punya atribut
aria-labeldeskriptif dandata-aksi="simpan-tugas". Gunakan browser DevTools untuk memverifikasi bahwa atribut-atribut itu muncul dengan benar di DOM.
Penutup
Atribut JSX mengikuti JavaScript, bukan HTML, itulah inti dari semua aturan di bab ini. className bukan class, htmlFor bukan for, style menerima objek bukan string, dan atribut event ditulis dalam camelCase. Pengecualiannya hanya aria-* dan data-* yang tetap mempertahankan format tanda hubung.
Pemahaman ini penting tidak hanya untuk menghindari error, tapi juga untuk bisa membaca kode React orang lain dengan percaya diri. Kamu sudah memiliki fondasi JSX yang cukup solid sekarang, ekspresi di bab sebelumnya, atribut di bab ini. Yang belum kita bahas adalah bagaimana JSX menangani kondisi: menampilkan satu hal atau hal lain berdasarkan suatu kondisi. Itu yang akan kita dalami di bab selanjutnya.