Dikomentari dengan benar HTML markup adalah bagian penting dari halaman web yang dibangun dengan baik. Komentar tersebut mudah ditambahkan, dan siapa pun yang harus mengerjakan kode situs tersebut di masa mendatang (termasuk Anda sendiri atau anggota tim yang bekerja sama dengan Anda) akan berterima kasih atas komentar tersebut.
Cara Menambahkan Komentar HTML
HTML dapat ditulis dengan editor teks standar, seperti Notepad++ untuk Windows atau TextEdit untuk Mac. Anda juga dapat menggunakan program web design-centric seperti Adobe Dreamweaver atau bahkan platform CMS seperti Wordpress atau ExpressionEngine. Terlepas dari alat yang Anda gunakan untuk membuat HTML, jika Anda bekerja langsung dengan kode, Anda akan menambahkan komentar HTML seperti ini:
Tambahkan bagian pertama dari tag komentar HTML:
Setelah bagian pembuka komentar itu, tulis teks apa pun yang Anda ingin tampilkan untuk komentar ini. Ini kemungkinan akan menjadi petunjuk bagi Anda atau pengembang lain di masa mendatang. Misalnya, jika Anda ingin menentukan di mana bagian tertentu pada halaman dimulai atau diakhiri dengan markup, Anda dapat menggunakan komentar untuk merincinya.
Setelah teks komentar Anda selesai, tutup tag komentar seperti ini:
Jadi secara total, komentar Anda akan terlihat seperti ini:
Ini sangat sederhana.
Tampilan Komentar
Setiap komentar yang Anda tambahkan ke kode HTML Anda akan muncul di kode itu ketika seseorang melihat sumber halaman web atau membuka HTML di editor untuk membuat beberapa perubahan. Namun, teks komentar tersebut tidak akan muncul di browser web saat pengunjung biasa datang ke situs. Tidak seperti elemen HTML lainnya, termasuk paragraf, judul, atau daftar, yang benar-benar memengaruhi halaman di dalam browser tersebut, komentar sebenarnya adalah bagian "di belakang layar" halaman.
Komentar untuk Tujuan Pengujian
Karena komentar tidak muncul di browser web, komentar dapat digunakan untuk "mematikan" bagian halaman selama pengujian atau pengembangan halaman. Jika Anda menambahkan bagian pembuka komentar langsung sebelum bagian halaman/kode yang ingin Anda sembunyikan, lalu Anda menambahkan bagian penutup di akhir kode itu (komentar HTML dapat menjangkau beberapa baris, sehingga Anda dapat membuka komentar pada katakanlah baris 50 kode Anda dan tutup pada baris 75 tanpa masalah), maka elemen HTML apa pun yang termasuk dalam komentar itu tidak akan lagi ditampilkan di peramban. Mereka akan tetap berada dalam kode Anda, tetapi tidak akan memengaruhi tampilan visual halaman. Jika Anda perlu menguji halaman untuk melihat apakah bagian tertentu menyebabkan masalah, dll., mengomentari area tersebut lebih baik daripada menghapusnya. Dengan komentar, jika bagian kode yang dipermasalahkan terbukti bukan masalah, Anda dapat dengan mudah menghapus bagian komentar dan kode itu akan ditampilkan sekali lagi. Pastikan bahwa komentar yang digunakan untuk pengujian ini tidak masuk ke situs web produksi. Jika area halaman tidak boleh ditampilkan, Anda ingin menghapus kode, bukan hanya mengomentarinya, sebelum Anda meluncurkan situs itu.
Salah satu penggunaan komentar HTML yang hebat selama pengembangan adalah ketika Anda sedang membangun situs web yang responsif. Karena bagian yang berbeda dari situs itu akan mengubah tampilannya berdasarkan ukuran layar yang berbeda, termasuk beberapa area yang mungkin tidak ditampilkan sama sekali, menggunakan komentar untuk mengaktifkan atau menonaktifkan bagian halaman dapat menjadi trik cepat dan mudah untuk digunakan selama pengembangan.
Mengenai Performa
Saya telah melihat beberapa profesional web menyarankan bahwa komentar harus dihapus dari file HTML dan CSS untuk mengurangi ukuran file tersebut dan membuat halaman yang memuat lebih cepat. Sementara saya setuju bahwa halaman harus dioptimalkan untuk kinerja dan harus memuat dengan cepat, masih ada tempat untuk penggunaan komentar yang cerdas dalam kode. Ingat, komentar ini dimaksudkan untuk mempermudah pengerjaan situs di masa mendatang, selama Anda tidak berlebihan komentar ditambahkan ke setiap baris dalam kode Anda, jumlah kecil ukuran file yang ditambahkan ke halaman karena komentar harus lebih dari dapat diterima.
Tips Menggunakan Komentar
Beberapa hal yang harus diperhatikan atau diingat saat menggunakan komentar HTML:
- Komentar bisa beberapa baris.
- Gunakan komentar untuk mendokumentasikan pengembangan halaman Anda.
- Komentar juga dapat mendokumentasikan konten, baris atau kolom tabel, melacak perubahan, atau apa pun yang Anda inginkan.
- Komentar yang "mematikan" area situs tidak boleh membuatnya menjadi produksi kecuali perubahan ini adalah yang sementara yang akan dibalik dalam waktu singkat (seperti mengaktifkan atau menonaktifkan pesan peringatan sebagai dibutuhkan).