BAB 31: Kode Komputer
Elemen code, pre, kbd, samp, dan var untuk menampilkan kode dan output program.
Penutup bab sebelumnya menyinggung satu hal yang sering dilewatkan: menampilkan kode di dalam halaman web dengan cara yang benar secara semantik. Ini bukan sekadar soal tampilan monospace, ada makna di balik pilihan elemen yang kita gunakan. Halaman portofolio Budi kini sudah responsif, dan saatnya kita pikirkan konten yang lebih kaya: bagaimana jika Budi ingin mendokumentasikan proyek-proyeknya lengkap dengan contoh kode, perintah terminal, dan output yang dihasilkan?
HTML menyediakan sekumpulan elemen khusus untuk kebutuhan ini. Kelimanya mewakili konteks yang berbeda, bukan sekadar variasi font.
Mengapa Elemen Semantik untuk Kode?
Bisa saja kita menampilkan kode dengan <span style="font-family: monospace;"> dan hasilnya terlihat sama di layar. Tapi browser, screen reader, dan mesin pencari tidak tahu bahwa teks itu adalah kode program. Mereka membacanya seperti teks biasa.
Elemen semantik seperti <code> memberi sinyal eksplisit: "ini adalah kode." Screen reader bisa menyampaikannya dengan nada yang berbeda. Mesin pencari bisa mengindeks snippet kode dengan lebih tepat. Dan developer lain yang membaca markup kamu langsung paham konteksnya.
Elemen code
<code> menandai potongan kode inline, nama fungsi, nama variabel, nama file, atau ekspresi pendek yang muncul di tengah kalimat.
<!-- portofolio.html -->
<section id="proyek">
<h2>Proyek Terbaru</h2>
<article class="kartu-proyek">
<h3>Aplikasi Manajemen Tugas</h3>
<p>
Dibangun dengan HTML, CSS, dan JavaScript murni. State aplikasi
disimpan di <code>localStorage</code> sehingga tugas tidak hilang
saat halaman di-refresh.
</p>
<a href="https://github.com/budisantoso/task-app">Lihat di GitHub</a>
</article>
</section>
Browser menampilkan <code> dengan font monospace secara default. Ini cukup untuk nama fungsi, properti, atau istilah teknis pendek yang muncul di dalam narasi.
<code> tidak mempertahankan whitespace atau baris baru. Jika kamu menulis beberapa baris kode langsung di dalam <code>, semua spasi berlebih akan diciutkan. Untuk blok kode multi-baris, gunakan kombinasi <pre> dan <code> yang akan kita bahas berikutnya.
Elemen pre
<pre> menampilkan teks apa adanya, setiap spasi, tab, dan baris baru dipertahankan persis seperti yang ditulis di HTML. Ini berguna untuk blok kode yang butuh format vertikal.
Kombinasi <pre><code> adalah pola standar untuk blok kode multi-baris:
<!-- portofolio.html -->
<article class="kartu-proyek">
<h3>Aplikasi Manajemen Tugas</h3>
<p>Contoh cara menyimpan tugas ke <code>localStorage</code>:</p>
<pre><code>function simpanTugas(daftarTugas) {
const data = JSON.stringify(daftarTugas);
localStorage.setItem('tugas', data);
}
function muatTugas() {
const data = localStorage.getItem('tugas');
return data ? JSON.parse(data) : [];
}</code></pre>
</article>
Perhatikan bahwa tidak ada indentasi antara tag <pre> dan <code> dengan konten di dalamnya. Ini disengaja, karena <pre> mempertahankan whitespace, spasi atau baris kosong di awal konten akan ikut tampil di halaman.
Jangan beri indentasi pada konten di dalam <pre>. Jika HTML kamu diindentasi dan konten <pre> ikut diindentasi, output di browser akan menampilkan spasi kosong di depan setiap baris, merusak tampilan kode.
Elemen kbd
<kbd> (keyboard) menandai teks yang mewakili input dari keyboard, tombol yang harus ditekan pengguna. Ini berbeda dari kode program; <kbd> adalah instruksi interaksi.
<!-- portofolio.html -->
<article class="kartu-proyek">
<h3>Aplikasi Manajemen Tugas</h3>
<p>
Tekan <kbd>Enter</kbd> untuk menambahkan tugas baru, atau
<kbd>Ctrl</kbd>+<kbd>Z</kbd> untuk membatalkan perubahan terakhir.
</p>
</article>
Browser menampilkan <kbd> dengan font monospace, mirip <code>. Perbedaannya ada di semantik: <kbd> secara eksplisit berarti "ini adalah input keyboard dari pengguna." Beberapa stylesheet menambahkan tampilan seperti tombol fisik dengan border dan border-radius untuk elemen ini.
Elemen samp
<samp> (sample output) menandai teks yang merupakan output dari program komputer, pesan di terminal, log aplikasi, atau respons yang dihasilkan sistem.
<!-- portofolio.html -->
<article class="kartu-proyek">
<h3>Dashboard Cuaca</h3>
<p>
Ketika API berhasil dipanggil, konsol akan menampilkan:
<samp>Data cuaca berhasil dimuat: Jakarta, 32°C</samp>
</p>
<p>
Jika terjadi error koneksi, pesan yang muncul:
<samp>Gagal mengambil data. Periksa koneksi internet kamu.</samp>
</p>
</article>
<samp> juga menggunakan font monospace secara default. Perbedaannya dengan <code>: <code> adalah kode yang ditulis programmer, sedangkan <samp> adalah output yang dihasilkan program.
Elemen var
<var> menandai variabel, dalam ekspresi matematika maupun dalam kode program. Browser biasanya menampilkannya dengan gaya italic.
<!-- portofolio.html -->
<article class="kartu-proyek">
<h3>Kalkulator Anggaran</h3>
<p>
Total pengeluaran dihitung dengan rumus:
<var>total</var> = <var>harga</var> × <var>jumlah</var> − <var>diskon</var>
</p>
<p>
Nilai <var>diskon</var> akan bernilai <code>0</code> jika total
belanja di bawah batas minimum.
</p>
</article>
<var> paling sering muncul dalam dokumentasi teknis atau penjelasan algoritma. Ketika kamu menjelaskan rumus atau logika program kepada pembaca, <var> memberi penekanan visual bahwa kata itu adalah nama variabel, bukan kata biasa.
Perbedaan Keempat Elemen
Keempat elemen ini sering membingungkan karena tampilannya mirip. Tabel berikut merangkum konteks penggunaan masing-masing:
| Elemen | Konteks | Contoh |
|---|---|---|
<code> | Kode program atau perintah | localStorage.setItem() |
<kbd> | Input dari pengguna (tombol keyboard) | Tekan Enter |
<samp> | Output yang dihasilkan program | Error: file not found |
<var> | Nama variabel dalam kode atau matematika | total = harga × jumlah |
Dokumentasi Proyek yang Lengkap
Menggabungkan semua elemen ini, inilah bagian dokumentasi portofolio.html yang kini kaya secara semantik:
<!-- portofolio.html -->
<section id="proyek">
<h2>Proyek Terbaru</h2>
<article class="kartu-proyek">
<h3>Aplikasi Manajemen Tugas</h3>
<p>
Dibangun dengan HTML, CSS, dan JavaScript murni. Data disimpan di
<code>localStorage</code> menggunakan fungsi sederhana:
</p>
<pre><code>function simpanTugas(daftarTugas) {
localStorage.setItem('tugas', JSON.stringify(daftarTugas));
}</code></pre>
<p>
Tekan <kbd>Enter</kbd> untuk menyimpan tugas. Jika berhasil,
konsol menampilkan: <samp>Tugas berhasil disimpan.</samp>
</p>
<p>
Jumlah tugas aktif disimpan di variabel <var>jumlahAktif</var>
dan diperbarui setiap kali pengguna mencentang tugas selesai.
</p>
<a href="https://github.com/budisantoso/task-app">Lihat di GitHub</a>
</article>
</section>
Markup ini tidak hanya tampil bagus di browser, ia menyampaikan konteks yang berbeda untuk setiap jenis teks teknis. <code> untuk nama fungsi, <pre><code> untuk blok kode, <kbd> untuk tombol yang harus ditekan pengguna, <samp> untuk output yang dihasilkan, dan <var> untuk nama variabel dalam penjelasan.
Latihan
Buka bagian dokumentasi di portofolio.html dan terapkan elemen yang tepat:
-
Ambil satu paragraf yang menyebut nama fungsi atau properti JavaScript secara inline. Bungkus nama fungsi tersebut dengan
<code>. Perhatikan perubahan tampilannya di browser. -
Tuliskan satu contoh kode multi-baris untuk salah satu proyek Budi, minimal tiga baris. Gunakan kombinasi
<pre><code>dan pastikan tidak ada indentasi ekstra yang merusak tampilan. -
Tambahkan satu instruksi keyboard menggunakan
<kbd>dan satu contoh output menggunakan<samp>. Jika kamu punya stylesheet distyle.css, coba tambahkan CSS sederhana untukkbdagar terlihat seperti tombol fisik:border: 1px solid #999; border-radius: 3px; padding: 2px 6px;.
Halaman portofolio Budi sekarang bisa mendokumentasikan kode dengan benar. Tapi masih ada satu lapisan lagi yang perlu diperhatikan sebelum kita beranjak ke topik berikutnya: bagaimana HTML5 memberi nama yang tepat pada konten, bukan hanya layout, tapi makna dari setiap elemen yang kita pilih, dan mengapa itu penting bagi mesin pencari, screen reader, dan developer yang akan memelihara kode kamu.