BAB 33: Panduan Gaya
Konvensi penulisan HTML yang konsisten dan mudah dipelihara.
Sepanjang ebook ini, kita sudah menulis cukup banyak HTML, dari struktur dasar di Bab 3, elemen semantik di Bab 29 dan 32, hingga dokumentasi kode di Bab 31. Kalau kamu lihat kembali semua file portofolio.html yang kita bangun, ada pola tertentu yang konsisten di setiap bab: indentasi dua spasi, atribut selalu dikutip, nama elemen selalu huruf kecil. Ini bukan kebetulan.
Konvensi penulisan HTML adalah kesepakatan tidak tertulis yang membuat kode mudah dibaca oleh siapapun, termasuk dirimu sendiri tiga bulan ke depan, atau rekan tim yang baru bergabung. Bab ini merangkum konvensi-konvensi tersebut secara eksplisit, sehingga kamu bisa menulis HTML dengan sadar, bukan sekadar meniru pola.
Selalu Mulai dengan DOCTYPE
<!DOCTYPE html> harus ada di baris pertama setiap file HTML. Ini bukan tag HTML biasa, ini deklarasi yang memberitahu browser bahwa dokumen menggunakan standar HTML5.
<!-- portofolio.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Abd. Asis, Pengembang Web Frontend</title>
</head>
<body>
<!-- konten halaman -->
</body>
</html>
Tanpa <!DOCTYPE html>, beberapa browser masuk ke mode quirks, perilaku lama yang mensimulasikan cara browser tahun 1990-an merender halaman. Hasilnya tidak konsisten dan susah diprediksi.
Huruf Kecil untuk Nama dan Atribut
HTML tidak case-sensitive: <DIV>, <Div>, dan <div> semuanya valid. Tapi konvensi yang disepakati luas adalah selalu menggunakan huruf kecil, karena konsisten dengan XML/XHTML dan lebih mudah dibaca.
<!-- Buruk -->
<DIV CLASS="kartu-proyek">
<H3>Aplikasi Manajemen Tugas</H3>
</DIV>
<!-- Baik -->
<div class="kartu-proyek">
<h3>Aplikasi Manajemen Tugas</h3>
</div>
Aturan yang sama berlaku untuk nama atribut: selalu class, bukan CLASS atau Class.
Nilai Atribut Selalu Dikutip
Nilai atribut bisa ditulis tanpa tanda kutip jika tidak mengandung spasi: <img src=foto.jpg> valid secara teknis. Tapi ini membuka celah untuk bug yang susah dilacak.
<!-- Rentan error -->
<img src=foto proyek.jpg alt=Screenshot aplikasi>
<!-- Aman dan konsisten -->
<img src="foto-proyek.jpg" alt="Screenshot aplikasi manajemen tugas">
Begitu nilai atribut mengandung spasi (seperti nama file dengan spasi atau teks alt yang panjang) versi tanpa kutip akan gagal. Lebih mudah mengutip semua nilai atribut secara konsisten daripada mengingat mana yang perlu dikutip dan mana yang tidak.
Gunakan tanda kutip ganda (") secara konsisten, bukan tanda kutip tunggal. Keduanya valid, tapi tanda kutip ganda adalah konvensi yang jauh lebih umum di HTML.
Indentasi dan Struktur Hierarki
Indentasi dua spasi adalah standar yang paling umum di HTML. Setiap elemen yang bersarang di dalam elemen lain diindentasi satu level ke dalam.
<!-- portofolio.html -->
<main>
<section id="proyek">
<h2>Proyek Terbaru</h2>
<article class="kartu-proyek">
<h3>Dashboard Cuaca</h3>
<p>Dibangun menggunakan Fetch API.</p>
<figure>
<img src="img/screenshot-weather.jpg" alt="Dashboard cuaca">
<figcaption>Tampilan real-time dari OpenWeatherMap API.</figcaption>
</figure>
</article>
</section>
</main>
Indentasi yang konsisten memperlihatkan hierarki dokumen secara visual. Kamu bisa langsung melihat bahwa <article> ada di dalam <section>, dan <figure> ada di dalam <article>.
Tutup Semua Elemen
HTML5 memperbolehkan beberapa elemen tidak ditutup: <li>, <p>, <td> bisa berdiri tanpa tag penutup dan browser akan memparsing dengan benar. Tapi ini membuat kode susah dibaca dan bisa menimbulkan hasil yang tidak terduga di beberapa parser.
<!-- Diperbolehkan tapi tidak disarankan -->
<ul>
<li>HTML & CSS
<li>JavaScript
<li>React
</ul>
<!-- Lebih jelas dan konsisten -->
<ul>
<li>HTML & CSS</li>
<li>JavaScript</li>
<li>React</li>
</ul>
Elemen void seperti <img>, <br>, <input>, dan <meta> memang tidak punya tag penutup, dan tidak perlu menulis <img /> dengan garis miring penutup (itu sintaks XHTML, bukan HTML5).
Atribut alt, width, dan height pada Gambar
Setiap elemen <img> harus punya atribut alt. Ini bukan opsional, ia penting untuk aksesibilitas dan ditampilkan ketika gambar gagal dimuat.
<!-- portofolio.html -->
<!-- Buruk: tanpa alt -->
<img src="img/screenshot-task-app.jpg">
<!-- Baik: dengan alt deskriptif -->
<img
src="img/screenshot-task-app.jpg"
alt="Antarmuka aplikasi manajemen tugas dengan daftar tugas aktif"
width="800"
height="450"
>
Atribut width dan height membantu browser mengalokasikan ruang untuk gambar sebelum gambar selesai dimuat, mencegah layout shift yang membuat halaman terasa "melompat" saat diakses pertama kali.
Nama File dengan Huruf Kecil
Nama file HTML, CSS, gambar, dan aset lainnya sebaiknya menggunakan huruf kecil semua dengan pemisah tanda hubung.
<!-- Bermasalah di server Linux (case-sensitive) -->
<link rel="stylesheet" href="css/Style.css">
<img src="img/Screenshot-Task-App.JPG" alt="...">
<!-- Aman di semua server -->
<link rel="stylesheet" href="css/style.css">
<img src="img/screenshot-task-app.jpg" alt="...">
Server web di Linux membedakan huruf besar dan kecil. File Style.css dan style.css adalah dua file berbeda. Di Windows (yang sering dipakai untuk development), keduanya dianggap sama, sehingga bug ini tidak terdeteksi saat development tapi muncul begitu di-deploy ke server Linux.
Ini adalah salah satu bug paling umum saat pertama kali deploy: halaman tampil bagus di localhost tapi stylesheet atau gambar tidak muncul di server. Hampir selalu karena perbedaan huruf besar/kecil pada nama file.
Elemen title Wajib Ada
<title> di dalam <head> adalah satu-satunya elemen yang paling berdampak pada SEO dan pengalaman pengguna. Teks di dalamnya muncul di tab browser, hasil pencarian Google, dan bookmark.
<!-- portofolio.html -->
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Abd. Asis, Pengembang Web Frontend</title>
</head>
Judul yang baik deskriptif, unik per halaman, dan tidak terlalu panjang (idealnya di bawah 60 karakter agar tidak terpotong di hasil pencarian).
Atribut lang pada html
Atribut lang di <html> memberitahu browser dan screen reader dalam bahasa apa konten halaman ditulis. Ini penting untuk aksesibilitas dan terjemahan otomatis.
<!-- Untuk halaman berbahasa Indonesia -->
<!DOCTYPE html>
<html lang="id">
<!-- Untuk halaman berbahasa Inggris -->
<!DOCTYPE html>
<html lang="en">
Screen reader menggunakan nilai lang untuk memilih aksen dan aturan pelafalan yang tepat. Tanpa atribut ini, screen reader mungkin membacakan teks bahasa Indonesia dengan aturan pelafalan bahasa Inggris.
Ringkasan Konvensi
Semua konvensi yang sudah dibahas bisa dirangkum dalam satu template dasar yang bisa dijadikan titik awal untuk setiap halaman HTML baru:
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Judul Halaman yang Deskriptif</title>
<link rel="stylesheet" href="css/style.css">
</head>
<body>
<header>
<!-- navigasi dan identitas situs -->
</header>
<main>
<!-- konten utama halaman -->
</main>
<footer>
<!-- informasi penutup -->
</footer>
<script src="js/portofolio.js"></script>
</body>
</html>
Template ini mengaplikasikan semua yang sudah kita bahas: <!DOCTYPE html>, atribut lang, meta charset dan viewport, <title>, struktur semantik, nama file huruf kecil, dan elemen <script> di akhir <body> (agar tidak memblokir rendering konten).
Latihan
Review portofolio.html yang sudah kamu bangun dan audit konvensinya:
-
Periksa semua nama file yang direferensikan: stylesheet di
<link>, gambar di<img>, dan script di<script>. Apakah semuanya menggunakan huruf kecil? Perbaiki jika ada yang tidak konsisten. -
Cari satu elemen
<img>yang belum punya atributwidthdanheight. Buka gambar tersebut di file manager untuk melihat dimensi aslinya, lalu tambahkan kedua atribut tersebut. -
Buka
portofolio.htmldi dua browser berbeda (Chrome dan Firefox). Bandingkan apakah ada perbedaan tampilan. Jika ada, periksa apakah DOCTYPE sudah benar dan elemen-elemen sudah ditutup dengan tepat.
Kode yang mengikuti konvensi bukan hanya lebih mudah dibaca, ia juga lebih mudah di-debug dan dipelihara. Ini adalah modal yang akan kamu bawa ke setiap proyek web berikutnya. Di bab-bab selanjutnya, kita akan beralih ke topik yang lebih spesifik: karakter-karakter khusus yang perlu penanganan tersendiri di HTML.