Icon
Ikon adalah teks: <span class="ic" aria-hidden="true">search</span>, digambar oleh font ligatur dari set Solar. Hanya nama di icons/icons.json yang ada; nama lain tidak menampilkan apa pun, tanpa pesan.
Penggunaan
Pakai saat
- Sebuah label jadi lebih cepat dibaca dengan glyph yang sudah dikenal orang: cari, tambah, unduh, kalender, pengaturan.
- Di dalam komponen yang mengharapkannya: tombol sebelum labelnya, icon button, baris daftar, alert, badge, empty state.
- Status terpilih atau berisi butuh gaya tebal (
ic--fill): toggle yang tertekan, hati yang disukai, tab saat ini.
Pakai yang lain saat
- Ikon yang bisa diklik tanpa teks: pakai Icon button.
.icpolos hanya hiasan; tombol memberinya target 44 px, nama, dan tooltip. - Kotak kecil berwarna yang membedakan baris di daftar pengaturan: pakai List. Pakai
.lrow--icondengan.lrow__icon. - Seseorang atau organisasi: pakai Avatar.
- Titik yang menyatakan online, offline, atau siaran langsung: pakai Status dot.
- Ikon yang berganti makna saat ditekan (salin ke disalin, putar ke jeda): pakai Icon swap.
Letaknya. Sebelum teks yang dijelaskannya, berjarak 6 sampai 10 px (komponen yang mengatur jaraknya). Ikon mengikuti currentColor, jadi memakai warna teks induknya; ikon redup memakai --text-subtle atau --text-muted. Di ponsel ukurannya sama; jangan pernah mengecilkan ikon agar muat.
Contoh
<div class="docs-row" style="color: var(--text-strong);"> <span class="ic" aria-hidden="true">star</span> <span class="ic ic--fill" aria-hidden="true" style="color: var(--warning);">star</span> <span class="ic" aria-hidden="true">bookmark</span> <span class="ic ic--fill" aria-hidden="true" style="color: var(--accent-text);">bookmark</span> <span class="ic" aria-hidden="true">notifications</span> <span class="ic ic--fill" aria-hidden="true">notifications</span> </div>
<div class="docs-row" style="color: var(--text-strong);"> <span class="ic ic--sm" aria-hidden="true">calendar_month</span> <span class="ic" aria-hidden="true">calendar_month</span> <span class="ic ic--lg" aria-hidden="true">calendar_month</span> </div>
<div class="docs-col" style="max-width: 420px;"> <button class="btn btn--secondary"><span class="ic" aria-hidden="true">download</span>Unduh bukti pendaftaran</button> <span class="badge badge--success"><span class="ic" aria-hidden="true">check</span>Disetujui</span> <span class="field__help"><span class="ic" aria-hidden="true">info</span>Izin Anda berlaku setelah ditandatangani kepala dinas.</span> </div>
<span class="ic ic--fill" role="img" aria-label="Terverifikasi" style="color: var(--success-text);">check_circle</span>
Anatomi
| Bagian | Fungsinya |
|---|---|
.ic | Wajib. <span> yang teksnya adalah nama ikon. 20 px, gaya garis, persegi 1em, tidak pernah turun baris. |
.ic--fill | Gaya tebal (berisi) dari font kedua, untuk status terpilih dan berisi. |
.ic--sm / .ic--lg | 16 px (baris padat, badge, tombol kecil) / 24 px (header halaman, empty state). |
aria-hidden="true" | Wajib saat ada teks terlihat di sampingnya, yang hampir selalu terjadi. |
Varian dan ukuran
| Kelas atau atribut | Kapan |
|---|---|
ic--fill | Gaya tebal untuk status terpilih, tertekan, dan berisi. Toggle tertekan, ikon alert, chip ikon daftar, dan thumbnail petak berkas otomatis beralih ke gaya ini. |
ic--sm | 16 px. |
ic--lg | 24 px. |
style="color: …" | Hanya dengan token (--text-subtle, --accent-text, --success-text); jangan pernah hex mentah. |
Gerak dan mikrointeraksi
- Ikon tidak bergerak sendiri. Saat satu ikon berganti makna, pakai icon swap: glyph lama mengecil ke 0.5 dan blur 4 px dalam
--d-fastsementara yang baru mendarat dengan--spring-snappyselama--d-snappy. - Chevron yang membuka sesuatu berputar 180 derajat dengan
--spring-smooth(split button, tool call, accordion); putaran itu milik komponennya. - Tidak ada ikon berputar untuk memuat: pakai spinner.
Aksesibilitas
- Dekoratif (di samping teks):
aria-hidden="true". Ini bawaannya; tanpa itu pembaca layar membacakan nama ligaturnya ("calendar_month"). - Bermakna dan berdiri sendiri:
role="img"danaria-labeldalam kata sederhana. - Kontrol hanya ikon adalah icon button dengan
aria-label; label dipasang pada tombol, bukan span. - Jangan pernah mengandalkan warna ikon saja untuk status; pasangkan dengan kata-kata.
Lakukan dan hindari
Lakukan
- Periksa nama di
icons/icons.jsonsebelum memakainya. - Pilih ikon karena maknanya; jika tidak ada yang cocok, jangan pakai ikon.
- Pakai gaya isi untuk "menyala", gaya garis untuk "mati".
Hindari
- Memakai
<svg>atau emoji jika ikon sistem tersedia, atau mencampur set ikon lain. - Mengarang nama:
arrow_right,trash, danusertampil kosong (namanyaarrow_forward,delete,person). - Menghias heading atau fitur "AI" dengan glyph kilauan atau sejenisnya.
Perilaku dan kode
HTML biasa. Tidak ada. Untuk menambah ikon: tambahkan "my_name": "solar-base-name" ke icons/icons.json lalu jalankan npm run build:icons.