Konten dan Kode

BAB 32: Semantik HTML

Menggunakan elemen semantik yang tepat untuk konten yang bermakna dan aksesibel.

Di Bab 29 kita sudah membangun struktur layout portofolio Budi menggunakan elemen seperti <header>, <main>, dan <footer>. Di Bab 31, elemen seperti <code> dan <kbd> membantu mendokumentasikan kode dengan tepat. Keduanya adalah contoh dari prinsip yang sama: pilih elemen berdasarkan makna, bukan penampilan.

Ini adalah inti dari semantik HTML. Halaman yang ditulis dengan HTML semantik bukan hanya terlihat benar di browser, ia juga dapat dipahami oleh mesin pencari, screen reader, dan developer yang akan memelihara kode tersebut bertahun-tahun kemudian.

Non-Semantik vs Semantik

Bayangkan dua blok markup yang menghasilkan tampilan visual identik di browser:

HTMLHTML
<!-- Pendekatan non-semantik -->
<div class="artikel-berita">
  <div class="judul-artikel">Dashboard Cuaca Budi Raih 1000 Pengguna</div>
  <div class="isi-artikel">
    Aplikasi cuaca sederhana yang dibangun Budi menggunakan Fetch API
    kini telah digunakan lebih dari 1000 orang...
  </div>
</div>
HTMLHTML
<!-- Pendekatan semantik -->
<article>
  <h2>Dashboard Cuaca Budi Raih 1000 Pengguna</h2>
  <p>
    Aplikasi cuaca sederhana yang dibangun Budi menggunakan Fetch API
    kini telah digunakan lebih dari 1000 orang...
  </p>
</article>

Kedua blok ini bisa tampil identik di browser dengan styling yang sama. Tapi mesin pencari membaca versi kedua dan langsung tahu: ini adalah artikel dengan judul dan paragraf konten. Screen reader melihat <article> dan menginformasikan ke pengguna bahwa mereka sedang membaca konten mandiri, lalu melompat langsung ke heading.

Versi pertama? Semua yang bisa disimpulkan adalah: ada beberapa <div> bersarang.

Elemen Semantik yang Sudah Kita Kenal

Kita sudah menggunakan beberapa elemen semantik secara langsung di bab-bab sebelumnya. Mereka membentuk fondasi struktur halaman:

  • <header>, konten pengantar halaman atau seksi
  • <nav>, blok navigasi utama
  • <main>, konten utama halaman (hanya satu per halaman)
  • <section>, pengelompokan tematik dengan heading
  • <article>, konten mandiri yang bisa berdiri sendiri
  • <aside>, konten yang berkaitan tidak langsung (sidebar, catatan tambahan)
  • <footer>, informasi penutup halaman atau seksi

Ini adalah elemen semantik struktural, mereka mendefinisikan landmark navigasi di halaman. Tapi semantik HTML tidak berhenti di sini.

Elemen figure dan figcaption

<figure> membungkus konten yang mandiri dan bisa dipindahkan dari alur dokumen tanpa mengubah makna teks di sekitarnya, gambar, diagram, blok kode, tabel, kutipan panjang. <figcaption> memberikan keterangan untuk konten di dalam <figure>.

HTMLHTML
<!-- portofolio.html -->
<article class="kartu-proyek">
  <h3>Dashboard Cuaca</h3>
  <figure>
    <img
      src="img/screenshot-weather.jpg"
      alt="Tampilan dashboard cuaca menunjukkan suhu Jakarta 32 derajat"
    >
    <figcaption>Dashboard cuaca menampilkan data real-time dari OpenWeatherMap API.</figcaption>
  </figure>
  <p>
    Dibangun menggunakan <code>fetch()</code> untuk mengambil data dari API
    dan merender hasilnya ke DOM tanpa library tambahan.
  </p>
</article>

<figcaption> bisa diletakkan sebelum atau sesudah konten di dalam <figure>. Jika diletakkan pertama, ia menjadi judul; jika terakhir, ia menjadi keterangan. Keduanya valid secara HTML.

Gunakan <figure> juga untuk blok kode yang ingin diberi label. Ini adalah pola yang umum digunakan dalam dokumentasi teknis:

HTMLHTML
<figure>
  <pre><code>localStorage.setItem('tugas', JSON.stringify(daftarTugas));</code></pre>
  <figcaption>Menyimpan array tugas ke localStorage dalam format JSON.</figcaption>
</figure>

Elemen time

<time> menandai tanggal atau waktu yang dapat dibaca mesin. Atribut datetime menyimpan nilai dalam format standar ISO 8601 yang dimengerti mesin pencari dan kalender, sementara konten di antara tag bisa ditulis dalam format apapun yang nyaman dibaca manusia.

HTMLHTML
<!-- portofolio.html -->
<footer>
  <p>Budi Santoso &copy; <time datetime="2026">2026</time></p>
  <p>
    Proyek terakhir diperbarui:
    <time datetime="2026-03-15">15 Maret 2026</time>
  </p>
</footer>

Tanpa <time>, mesin pencari tidak bisa membedakan "2026" sebagai tahun dari "2026" sebagai nomor lain. Dengan datetime="2026-03-15", ambiguitas itu hilang.

Elemen mark

<mark> menandai teks yang relevan dalam konteks tertentu, seperti hasil highlight di halaman hasil pencarian, atau bagian teks yang sedang dikutip.

HTMLHTML
<!-- portofolio.html -->
<article class="kartu-proyek">
  <h3>Aplikasi Manajemen Tugas</h3>
  <p>
    Aplikasi ini dibangun menggunakan teknologi web modern tanpa framework:
    <mark>vanilla JavaScript</mark> untuk logika, CSS Grid untuk layout,
    dan localStorage untuk persistensi data.
  </p>
</article>

<mark> berbeda dari <strong> dan <em>. <strong> menekankan kepentingan (konten ini penting. <em> memberikan tekanan) baca kalimat ini dengan penekanan di sini. <mark> berarti relevansi, ini yang sedang kamu cari atau ini yang perlu disorot dalam konteks ini.

Elemen details dan summary

<details> membuat widget disclosure, konten yang tersembunyi dan bisa dibuka oleh pengguna. <summary> adalah label yang selalu terlihat dan menjadi tombol toggle.

HTMLHTML
<!-- portofolio.html -->
<article class="kartu-proyek">
  <h3>Aplikasi Manajemen Tugas</h3>
  <p>Dibangun dengan HTML, CSS, dan JavaScript murni.</p>

  <details>
    <summary>Lihat detail teknis</summary>
    <p>
      State aplikasi disimpan di <code>localStorage</code> menggunakan
      <code>JSON.stringify()</code>. Tidak ada dependensi eksternal,       semua logika ditulis dalam satu file <code>portofolio.js</code>.
    </p>
    <pre><code>function simpanTugas(daftarTugas) {
  localStorage.setItem('tugas', JSON.stringify(daftarTugas));
}</code></pre>
  </details>
</article>

<details> bekerja secara native tanpa JavaScript. Browser menangani toggle show/hide secara otomatis. Ini berguna untuk FAQ, catatan tambahan, atau detail teknis yang tidak perlu terlihat oleh semua pembaca.

Memilih Elemen yang Tepat

Pertanyaan yang sering muncul: kapan pakai <div>, kapan pakai elemen semantik? Panduan sederhananya:

Gunakan elemen semantik ketika kontenmu punya peran yang bisa dideskripsikan:

  • Konten ini adalah artikel mandiri → <article>
  • Konten ini adalah navigasi → <nav>
  • Konten ini adalah gambar dengan keterangan → <figure> + <figcaption>
  • Konten ini adalah tanggal → <time>
  • Konten ini adalah detail yang bisa disembunyikan → <details> + <summary>

Gunakan <div> ketika kamu membutuhkan wadah untuk keperluan styling atau JavaScript tanpa makna semantik yang jelas, misalnya container untuk grid layout, atau wrapper untuk animasi.

Tidak ada yang salah dengan <div>. Halaman web yang ditulis dengan baik menggunakan kombinasi keduanya: elemen semantik untuk konten yang punya makna, <div> dan <span> untuk keperluan presentasi murni.

Portofolio dengan Semantik Lengkap

Menggabungkan semua yang sudah kita pelajari, inilah bagian <main> dari portofolio.html yang kini semantik secara menyeluruh:

HTMLHTML
<!-- portofolio.html -->
<main>
  <section id="proyek">
    <h2>Proyek Terbaru</h2>

    <article class="kartu-proyek">
      <h3>Aplikasi Manajemen Tugas</h3>
      <p>
        Dibangun dengan <mark>vanilla JavaScript</mark> murni.
        Data disimpan di <code>localStorage</code>.
      </p>

      <figure>
        <img
          src="img/screenshot-task-app.jpg"
          alt="Antarmuka aplikasi manajemen tugas dengan daftar tugas aktif"
          style="max-width: 100%;"
        >
        <figcaption>Tampilan utama aplikasi dengan filter tugas aktif dan selesai.</figcaption>
      </figure>

      <details>
        <summary>Detail teknis</summary>
        <p>
          Semua state dikelola di memori dan disinkronkan ke
          <code>localStorage</code> setiap kali ada perubahan.
          Tekan <kbd>Enter</kbd> untuk menambah tugas baru.
        </p>
      </details>

      <p>
        Diperbarui terakhir:
        <time datetime="2026-03-01">1 Maret 2026</time>
      </p>
      <a href="https://github.com/budisantoso/task-app">Lihat di GitHub</a>
    </article>
  </section>
</main>

Setiap elemen di sini dipilih berdasarkan maknanya. <article> karena proyek ini adalah konten mandiri. <figure> karena gambar punya keterangan. <details> karena detail teknis adalah informasi opsional. <time> karena tanggal perlu dibaca mesin. Ini bukan hanya tentang kode yang bersih, ini tentang halaman yang dapat dipahami oleh siapapun yang mengaksesnya.

Latihan

Buka portofolio.html dan terapkan elemen semantik yang belum digunakan:

  1. Tambahkan <figure> dan <figcaption> untuk satu gambar proyek. Tulis alt text yang mendeskripsikan isi gambar (bukan tujuannya), dan keterangan yang menjelaskan konteks gambar tersebut.

  2. Bungkus tanggal di <footer> dengan <time> dan isi atribut datetime dengan format ISO 8601 yang tepat. Verifikasi dengan membuka DevTools dan memeriksa atribut elemen tersebut.

  3. Tambahkan <details> dan <summary> untuk satu proyek. Sembunyikan detail teknis (stack, cara kerja) di dalamnya. Klik elemen di browser dan pastikan toggle bekerja tanpa JavaScript.

Kita sudah menguasai cara memberi makna pada setiap bagian halaman, dari layout hingga konten teknis dan anotasi semantik. Tapi ada satu hal yang belum dibahas: bagaimana kita menulis HTML yang konsisten dan mudah dipelihara oleh tim? Di bab berikutnya, kita akan membahas konvensi penulisan HTML yang disepakati luas di komunitas web.

Referensi

  1. 1 MDN Web Docs: Semantics in HTML
  2. 2 MDN Web Docs: <figure>: The Figure with Optional Caption element
  3. 3 WHATWG HTML Living Standard: Semantics, structure, and APIs of HTML documents