CSS Tutorial

BAB 18: Ikon CSS

Menaruh ikon di halaman tanpa mengacaukan tata letak: pseudo-element, mask, font ikon, SVG inline, dan penanda aksesibilitas.

Tombol "Simpan", kolom pencarian, dan panah pada menu dropdown hampir selalu dihias ikon kecil. Ada 3 cara menaruhnya: pseudo-element CSS, font ikon, dan SVG inline. Ketiganya bisa menghasilkan tampilan yang sama, tetapi berbeda dalam cara mewarnai, cara mengatur ukuran, dan cara pembaca layar mengumumkannya.

Bab ini membahas ketiga cara itu beserta kapan masing-masing dipakai. Setelah bab ini selesai, kamu bisa menambahkan ikon ke tombol dan menu tanpa mengubah HTML menjadi berlapis-lapis, mewarnai ikon mengikuti warna teks, dan memastikan ikon dekoratif tidak dibacakan pembaca layar.

Tiga cara menaruh ikon

CaraBerkasMewarisi warna teksDibaca pembaca layar
pseudo-elementCSS saja atau berkas kecilperlu maskya, kalau content berisi teks
font ikon1 berkas hurufya, seperti teksya, dan bisa keliru
SVG inlinepotongan di HTMLya, lewat filltidak, kecuali diberi label

Urutan pemakaian yang saya pakai sekarang: SVG inline untuk ikon bermakna, mask untuk ikon dekoratif yang harus mengikuti warna apa pun, dan font ikon hanya kalau proyeknya memang sudah memakainya.

Ikon dari pseudo-element

Cara paling ringan adalah menambahkan ikon lewat ::before atau ::after, sehingga HTML tombol tidak perlu diubah.

CSSCSS
.tautan-luar::after {
  content: "↗";
  margin-left: 0.35em;
  font-size: 0.9em;
}

Karena content berisi karakter biasa, ikon seperti ini ikut terbaca sebagai teks, ikut berubah warna mengikuti color, dan ukurannya mengikuti font-size. Untuk tanda centang, panah, dan titik pemisah, cara ini cukup dan tidak menambah permintaan berkas apa pun.

Kelemahannya 2. Bentuk ikon terbatas pada karakter yang tersedia di huruf yang dipakai, dan hasilnya berbeda antar platform kalau karakternya diambil dari huruf sistem. Emoji juga tidak cocok dipakai sebagai ikon antarmuka: bentuknya berwarna, gayanya berbeda di setiap sistem, dan sebagian dibacakan pembaca layar dengan nama yang panjang.

mask-image untuk ikon yang mengikuti warna

Kalau ikonnya berupa berkas SVG tetapi harus bisa berubah warna mengikuti teks, solusinya mask-image. Ikon dipakai sebagai cetakan, dan warnanya berasal dari background-color.

CSSCSS
.panah-bawah {
  display: inline-block;
  width: 1em;
  height: 1em;
  background-color: currentColor;
  mask-image: url("/assets/icons/chevron.svg");
  mask-size: contain;
  mask-repeat: no-repeat;
  mask-position: center;
}

currentColor membuat warna ikon sama dengan warna teks di sekitarnya, termasuk saat tombol berubah warna ketika kursor berada di atasnya. Dengan background-image biasa, warna ikon sudah menempel di dalam berkas dan tidak bisa diubah dari CSS.

Safari versi lama masih memerlukan awalan -webkit-, dan menuliskannya 2 kali tidak merugikan:

CSSCSS
.panah-bawah {
  -webkit-mask-image: url("/assets/icons/chevron.svg");
  mask-image: url("/assets/icons/chevron.svg");
  -webkit-mask-size: contain;
  mask-size: contain;
}

Satu hal yang perlu diingat: mask-image memotong latar, jadi elemen yang memakainya harus punya ukuran jelas. width dan height sebesar 1em membuat ikon ikut membesar bersama ukuran teks, dan itu yang membuatnya konsisten di semua tempat.

Ikon sebagai background-image

Cara yang paling lama dipakai adalah menaruh ikon sebagai latar elemen, biasanya dengan background-position supaya tidak menabrak teks.

CSSCSS
.kolom-cari {
  padding-left: 2.25rem;
  background-image: url("/assets/icons/search.svg");
  background-repeat: no-repeat;
  background-position: 0.75rem center;
  background-size: 1rem 1rem;
}

Hasilnya rapi untuk kolom input, karena ikon menempel pada kotak input dan tidak ikut menggeser teks. Yang harus dihitung adalah padding-left: nilainya harus lebih besar daripada lebar ikon ditambah jarak, kalau tidak teks akan menimpa ikon.

Kelemahan cara ini: warna ikon tidak bisa diubah dari CSS. Untuk tema gelap, dibutuhkan berkas kedua dengan warna berbeda, atau beralih ke mask-image seperti bagian sebelumnya.

Untuk ikon sederhana, berkas terpisah pun tidak perlu karena SVG bisa ditulis langsung sebagai data URI:

CSSCSS
.centang {
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M2 8l4 4 8-8' fill='none' stroke='%232563eb' stroke-width='2'/%3E%3C/svg%3E");
  background-repeat: no-repeat;
  background-size: 1em 1em;
}

Data URI menghilangkan 1 permintaan berkas, dengan konsekuensi CSS menjadi lebih panjang dan warnanya terkunci pada nilai yang tertulis. Tanda # pada warna harus ditulis sebagai %23, karena # dianggap bagian dari fragmen URL.

Font ikon dan masalah yang dibawanya

Font ikon memakai 1 berkas huruf yang setiap karakternya berupa ikon. Cara pakainya mirip teks biasa, karena memang teks:

CSSCSS
@font-face {
  font-family: "Ikon";
  src: url("/assets/fonts/ikon.woff2") format("woff2");
  font-display: block;
}

.ikon {
  font-family: "Ikon";
  font-size: 1.25rem;
  line-height: 1;
}

Kelebihannya: warna mengikuti color, ukuran mengikuti font-size, dan 1 berkas memuat ratusan ikon. Sebelum SVG inline populer, cara ini yang paling banyak dipakai.

Masalahnya muncul di 3 tempat. Pertama, pembaca layar membaca karakter ikon sebagai huruf, sehingga tombol dengan ikon keranjang bisa diumumkan sebagai "huruf e" alih-alih "keranjang". Kedua, selama berkas huruf belum selesai diunduh, yang tampil adalah kotak kosong atau karakter lain, dan font-display: block menyembunyikan teks selama beberapa detik. Ketiga, ikon tidak bisa punya ketebalan garis berbeda, karena semuanya mengikuti bentuk huruf.

Kalau proyekmu masih memakai font ikon, tambahkan aria-hidden="true" pada elemen ikon dan sediakan teks yang bisa dibaca pembaca layar. Tanpa itu, nama tombolnya berubah menjadi karakter yang tidak berarti.

SVG inline sebagai pilihan utama

SVG yang ditulis langsung di HTML memberi kendali paling lengkap: warna bisa diwarisi, ukuran bisa diatur CSS, dan pembaca layar hanya membacanya kalau memang diminta.

HTMLHTML
<button class="tombol-simpan">
  <svg viewBox="0 0 24 24" aria-hidden="true" focusable="false">
    <path d="M5 12l5 5L19 7" fill="none" stroke="currentColor" stroke-width="2"/>
  </svg>
  Simpan
</button>

Kuncinya ada di stroke="currentColor", yang membuat garis ikon mengikuti color elemen induk. Tombol di atas otomatis berubah warna saat di-hover, tanpa aturan tambahan untuk ikonnya.

Ukuran ikon diatur CSS, bukan atribut di SVG:

CSSCSS
.tombol-simpan svg {
  width: 1.15em;
  height: 1.15em;
  flex: none;
}

1.15em membuat ikon sedikit lebih besar daripada teks, dan flex: none mencegahnya menyusut saat tombol menjadi sempit. Atribut width dan height di dalam SVG sebaiknya dihapus dan diganti viewBox, supaya CSS bisa menentukan ukurannya.

aria-hidden="true" dipakai karena ikon di dalam tombol itu dekoratif: teks "Simpan" sudah menjelaskan fungsinya. Membiarkan ikon terbaca akan menghasilkan pengumuman ganda. focusable="false" menutup perilaku lama Internet Explorer yang memasukkan SVG ke urutan Tab.

Menata ikon bersama teks

Ikon dan teks di dalam 1 tombol paling mudah ditata dengan flexbox.

CSSCSS
.tombol-simpan {
  display: inline-flex;
  align-items: center;
  gap: 0.5rem;
  padding: 0.6rem 1rem;
}

align-items: center menyelaraskan ikon dan teks pada garis tengah, dan gap mengatur jarak tanpa perlu margin pada salah satunya. Cara lama memakai vertical-align: middle pada img atau SVG, dan hasilnya sering meleset beberapa piksel karena vertical-align bekerja relatif terhadap garis dasar teks, bukan terhadap kotak.

Ikon yang berdiri sendiri tanpa teks, misalnya tombol tutup pada dialog, membutuhkan ukuran area klik yang cukup. Ikon 16px terlalu kecil untuk disentuh jari, jadi bungkus dengan padding:

CSSCSS
.tutup-dialog {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 2.75rem;
  height: 2.75rem;
  padding: 0;
  border: 0;
  background: transparent;
  cursor: pointer;
}

.tutup-dialog svg {
  width: 1.25rem;
  height: 1.25rem;
}

Ukuran 2,75rem atau 44px adalah ambang yang dipakai pedoman aksesibilitas untuk area sentuh minimum. Ikonnya tetap 20px, tetapi area yang bisa ditekan jauh lebih besar.

Ikon bermakna dan ikon dekoratif

Perbedaan ini menentukan apakah ikon perlu label atau tidak.

Ikon dekoratif hanya mengulang informasi yang sudah ada di teks. Contohnya ikon centang di samping tulisan "Tersimpan". Untuk kasus ini, ikon diberi aria-hidden="true" supaya tidak dibacakan.

Ikon bermakna membawa informasi yang tidak ada di teks. Contohnya tombol dengan ikon saja, atau ikon status pada daftar. Untuk kasus ini, sediakan teks yang tersembunyi secara visual tetapi tetap terbaca pembaca layar:

CSSCSS
.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip-path: inset(50%);
  white-space: nowrap;
  border: 0;
}
HTMLHTML
<button class="tutup-dialog">
  <svg aria-hidden="true" focusable="false"><!-- bentuk silang --></svg>
  <span class="sr-only">Tutup dialog</span>
</button>

Teknik ini menyembunyikan teks dari tampilan tanpa menghilangkannya dari pohon aksesibilitas. Memakai display: none atau visibility: hidden juga menyembunyikannya dari pembaca layar, sehingga tombolnya menjadi tidak bernama.

Menjaga ikon tetap tajam

Ikon SVG tetap tajam pada ukuran apa pun karena bentuknya berupa perhitungan, bukan piksel. Syaratnya 2: berkasnya memang SVG, dan viewBox-nya sesuai dengan bentuk aslinya.

HTMLHTML
<svg viewBox="0 0 24 24" aria-hidden="true">
  <path d="M12 3v18M3 12h18" stroke="currentColor" stroke-width="2"/>
</svg>

viewBox menentukan sistem koordinat internal, sehingga ikon bisa diperbesar tanpa kehilangan detail. Menghapus viewBox dan hanya menyisakan width serta height membuat ikon membesar seperti gambar biasa: bentuknya memanjang atau terpotong.

Untuk ikon bergaris, ketebalan garis ikut membesar bersama ikon kalau satuannya mengikuti koordinat. Pada ikon 24px dengan stroke-width: 2, memperbesar ikon menjadi 48px membuat garis terlihat 2 kali lebih tebal. Kalau ketebalan harus tetap, gunakan vector-effect="non-scaling-stroke" atau pakai stroke-width yang dihitung ulang.

Ikon berformat PNG masih dipakai untuk ilustrasi berwarna banyak, tetapi tidak cocok untuk ikon antarmuka. Pada layar kerapatan tinggi, PNG 24px akan tampak kabur kecuali disediakan versi 2 kali lebih besar, dan itu menambah berkas yang harus diunduh.

Latihan

Latihan 1. Buat tombol dengan ikon centang di kiri dan teks "Simpan" di kanan, memakai SVG inline dan currentColor. Ubah color tombol menjadi merah, lalu pastikan ikon ikut berubah tanpa aturan CSS tambahan.

Latihan 2. Buat 1 ikon panah memakai mask-image dengan background-color: currentColor. Bandingkan hasilnya dengan ikon yang sama memakai background-image, lalu jelaskan kenapa salah satunya bisa berubah warna.

Latihan 3. Buat tombol tutup berisi ikon silang tanpa teks. Tambahkan teks tersembunyi dengan pola .sr-only, lalu periksa nama tombol itu di panel Accessibility DevTools. Nama yang benar adalah "Tutup dialog", bukan nama berkas atau karakter kosong.

Ringkasan

Ikon bisa ditaruh lewat pseudo-element untuk tanda sederhana, mask-image untuk ikon yang harus mengikuti warna teks, background-image untuk latar kolom input, dan SVG inline untuk ikon bermakna. Font ikon mewarnai dan menskalakan ikon seperti teks, tetapi menyulitkan pembaca layar dan menyembunyikan teks selama berkas dimuat. Ikon dekoratif diberi aria-hidden="true", ikon bermakna diberi teks tersembunyi, dan ukuran area klik minimal 44px supaya tetap nyaman dipakai di layar sentuh.