CSS Tutorial

BAB 20: List CSS

Mengatur penanda daftar: jenis, posisi, penanda kustom lewat marker, dan cara menghapusnya tanpa merusak struktur bagi pembaca layar.

Daftar adalah satu-satunya elemen HTML yang membawa penanda bawaan: titik untuk daftar tak bernomor, angka untuk daftar bernomor. Penanda itu digambar oleh CSS, bukan oleh HTML, dan hampir semua kesulitan daftar berasal dari satu hal: penanda berada di luar kotak isi, sehingga jaraknya diatur oleh padding induk, bukan oleh margin item.

Bab ini membahas cara mengatur jenis penanda, memilih apakah penanda ikut masuk ke dalam teks, membuat penanda kustom, dan menghapus penanda untuk menu tanpa membuat daftar kehilangan maknanya. Setelah bab ini selesai, kamu bisa mengubah daftar menjadi menu horizontal maupun daftar bacaan bertanda panah, dengan jarak yang dihitung, bukan ditebak.

Tiga jenis daftar

ElemenKegunaanPenanda bawaan
uldaftar tanpa urutandisc, titik penuh
oldaftar berurutandecimal, angka 1, 2, 3
dldaftar istilah dan artinyatidak ada penanda

Perbedaan ul dan ol tidak berhenti pada tampilan. Pembaca layar mengumumkan jumlah item pada keduanya, dan pada ol urutannya ikut diumumkan. Memakai ul untuk langkah-langkah yang berurutan menghilangkan informasi urutan yang dibutuhkan pembaca.

dl dipakai untuk pasangan istilah dan penjelasan, misalnya daftar istilah di akhir buku atau spesifikasi produk. Isinya dt untuk istilah dan dd untuk penjelasannya.

list-style-type dan nilai yang tersedia

list-style-type menentukan bentuk penanda.

CSSCSS
.lingkaran { list-style-type: circle; }
.kotak     { list-style-type: square; }
.angka     { list-style-type: decimal; }
.huruf     { list-style-type: lower-alpha; }
.romawi    { list-style-type: upper-roman; }
.tanpa     { list-style-type: none; }

Untuk ol, ada beberapa nilai yang sering dipakai:

NilaiHasil
decimal1, 2, 3
decimal-leading-zero01, 02, 03
lower-alphaa, b, c
upper-alphaA, B, C
lower-romani, ii, iii
upper-romanI, II, III
lower-greekα, β, γ

Nilai bisa juga berupa teks sendiri, yang berguna untuk penanda khusus:

CSSCSS
.langkah {
  list-style-type: "→ ";
}

Teks itu ditulis di dalam tanda kutip dan ikut menjadi bagian penanda, termasuk spasinya. Untuk daftar yang penandanya perlu berurutan dengan format tertentu, misalnya "Langkah 1", yang dipakai adalah @counter-style, dan itu di luar cakupan bab ini.

list-style-position: di luar atau di dalam

Nilai bawaan adalah outside: penanda diletakkan di luar kotak isi item, dan baris kedua teks rata dengan baris pertama.

CSSCSS
.di-luar  { list-style-position: outside; }
.di-dalam { list-style-position: inside; }

Dengan inside, penanda masuk ke dalam kotak teks. Konsekuensinya terlihat saat item terdiri dari beberapa baris: baris kedua ikut menjorok masuk sejajar dengan penanda, bukan sejajar dengan huruf pertama.

Untuk daftar bacaan, outside hampir selalu lebih rapi. Untuk daftar pendek di dalam kotak sempit, misalnya daftar fitur di dalam kartu, inside kadang lebih menghemat ruang karena tidak perlu padding kiri.

Jarak penanda dari tepi kiri diatur oleh padding elemen induk, bukan margin item. Di Chromium, ul dan ol tanpa CSS tambahan memakai padding-left 40px dan margin 0. Artinya penanda menempati area 40px itu, dan teks item dimulai tepat setelahnya.

CSSCSS
.daftar-rapat {
  padding-left: 1.25rem;
}

Nilai 1.25rem atau 20px cukup untuk penanda disc, tetapi penanda decimal dengan angka 2 digit butuh ruang lebih. Kalau padding terlalu kecil, penanda akan menempel atau terpotong ke tepi jendela.

list-style-image dan batasannya

list-style-image memakai berkas gambar sebagai penanda.

CSSCSS
.daftar-centang {
  list-style-image: url("/assets/icons/check.svg");
}

Cara ini cepat, tetapi punya 2 batasan yang membuatnya jarang dipakai sekarang. Pertama, ukuran gambar tidak bisa diatur: penanda mengikuti ukuran intrinsik berkas, dan berkas 24px akan tampil 24px meskipun teksnya 14px. Kedua, posisi vertikalnya tidak bisa digeser, sehingga pada baris dengan line-height besar penanda terlihat tidak sejajar.

Alternatif yang lebih terkendali adalah ::marker dengan teks, atau background-image pada item beserta padding-left:

CSSCSS
.daftar-centang li {
  padding-left: 1.5rem;
  background-image: url("/assets/icons/check.svg");
  background-repeat: no-repeat;
  background-position: 0 0.35em;
  background-size: 1rem 1rem;
  list-style: none;
}

Dengan cara ini, ukuran dan posisi ikon bisa diatur, dan background-position memakai satuan em sehingga ikut menyesuaikan ukuran teks.

Menghapus penanda untuk menu

Pola yang paling sering dipakai: ul dijadikan menu, penandanya dihapus.

CSSCSS
.menu {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  gap: 1.25rem;
}

Ada 1 jebakan aksesibilitas di sini. Di Safari, list-style: none menghapus makna daftar dari elemen, sehingga VoiceOver tidak mengumumkan "daftar, 4 item", hanya membacakan tautannya satu per satu. Perilaku itu memang diatur di WebKit, dan cara mengembalikannya adalah menambahkan atribut peran secara eksplisit:

HTMLHTML
<ul class="menu" role="list">
  <li><a href="/">Beranda</a></li>
  <li><a href="/artikel">Artikel</a></li>
</ul>

Atribut role="list" memberi tahu pembaca layar bahwa elemen itu tetap daftar, meskipun penandanya tidak digambar. Ini satu-satunya kasus di mana menambahkan peran ARIA yang sama dengan elemen aslinya berguna, dan alasannya spesifik pada perilaku Safari.

::marker untuk penanda kustom

::marker memungkinkan penanda diubah tanpa menyentuh tata letak item.

CSSCSS
.daftar-panah li::marker {
  content: "→ ";
  color: #2563eb;
  font-weight: 600;
}

Properti yang didukung pada ::marker terbatas: content, semua properti font, color, white-space, direction, dan unicode-bidi. Properti seperti background, padding, dan border tidak berpengaruh. Kalau butuh penanda berbentuk kotak berwarna, yang dipakai adalah ::before pada li, bukan ::marker.

CSSCSS
.daftar-kotak li {
  list-style: none;
  padding-left: 1.4rem;
  position: relative;
}

.daftar-kotak li::before {
  content: "";
  position: absolute;
  left: 0;
  top: 0.55em;
  width: 0.5rem;
  height: 0.5rem;
  background-color: #2563eb;
  border-radius: 0.15rem;
}

Perbedaan penting antara keduanya: ::marker ikut dihitung sebagai bagian penanda daftar, sedangkan ::before adalah isi tambahan di dalam item. Untuk pembaca layar, content pada ::marker tidak diumumkan sebagai teks, sementara content pada ::before bisa ikut terbaca tergantung browser. Karena itu teks yang bermakna sebaiknya ditulis di HTML, bukan di content.

Penanda pada daftar bersarang

Daftar yang berada di dalam item daftar lain tetap memakai list-style-type dari induknya, kecuali diatur sendiri. Browser tidak mengganti bentuk penanda secara otomatis, jadi ul bersarang akan menampilkan titik yang sama di setiap tingkat.

CSSCSS
.daftar-utama {
  list-style-type: disc;
}

.daftar-utama ul {
  list-style-type: circle;
  margin-top: 0.35rem;
}

.daftar-utama ul ul {
  list-style-type: square;
}

Jarak vertikal antar-tingkat diatur margin pada ul di dalamnya, bukan pada li. Menambahkan margin pada li akan menggeser seluruh item, termasuk item yang tidak punya daftar anak.

Bentuk singkat list-style

list-style menggabungkan 3 properti: type, position, dan image, dalam urutan bebas.

CSSCSS
.ringkas {
  list-style: square inside;
}

Nilai yang tidak disebut akan kembali ke nilai awal, yaitu disc outside none. Jadi menulis list-style: square akan menghapus gambar penanda yang mungkin diatur sebelumnya, dan itu perilaku yang perlu diingat saat menimpa aturan lain.

Sama seperti font dan background, bentuk singkat ini sebaiknya dipakai saat semua nilai memang ingin ditetapkan sekaligus.

Menata daftar definisi

dl tidak punya penanda, tetapi punya masalah jarak sendiri: dd diberi margin-left 40px oleh browser, dan dt tidak.

CSSCSS
dl {
  margin: 0;
}

dt {
  font-weight: 600;
  margin-top: 1rem;
}

dd {
  margin: 0.25rem 0 0;
  color: #57606a;
}

Hasilnya pasangan istilah dan arti yang rapat, dengan arti menjorok 0 karena jaraknya diatur margin-top pada dt. Kalau ingin arti tetap menjorok, gunakan padding-left pada dd supaya jaraknya konsisten meskipun teksnya panjang.

Untuk daftar definisi 2 kolom, misalnya spesifikasi produk, susunannya lebih mudah dibuat dengan grid:

CSSCSS
.spesifikasi {
  display: grid;
  grid-template-columns: minmax(8rem, 30%) 1fr;
  gap: 0.5rem 1rem;
}

Setiap dt dan dd menjadi sel grid, sehingga istilah dan artinya rata per baris tanpa perlu menghitung lebar kolom.

Latihan

Latihan 1. Buat ul berisi 5 item, lalu ubah penandanya menjadi panah biru memakai ::marker. Ukur jarak penanda ke teks di DevTools sebelum dan sesudah padding-left diubah.

Latihan 2. Buat menu horizontal dari ul. Hapus penandanya, lalu periksa nama elemen di panel Accessibility. Tambahkan role="list" dan jelaskan perbedaannya.

Latihan 3. Buat daftar definisi berisi 3 istilah. Hapus margin-left bawaan pada dd, lalu susun ulang memakai grid 2 kolom.

Ringkasan

Penanda daftar diatur list-style-type untuk bentuk, list-style-position untuk letaknya di luar atau di dalam kotak isi, dan ::marker untuk penanda kustom dengan content serta warna. Jarak penanda ditentukan padding elemen induk, yang bawaannya 40px di Chromium. Saat penanda dihapus untuk menu, tambahkan role="list" supaya Safari tetap mengumumkannya sebagai daftar, dan untuk penanda berbentuk kotak atau gambar, ::before atau background-image memberi kendali yang tidak dimiliki list-style-image.