Proyek komunitas. Ini bukan situs resmi pemerintah.

Dikelola sukarelawan. Lampung Design System dibangun oleh komunitas open source. Tidak ada instansi pemerintah yang mengelola atau mendukungnya secara resmi.

Layanan resmi memakai go.id. Situs pemerintah Indonesia berakhiran .go.id. Jangan masukkan NIK di situs yang Anda ragukan.

Icon

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. .ic polos hanya hiasan; tombol memberinya target 44 px, nama, dan tooltip.
  • Kotak kecil berwarna yang membedakan baris di daftar pengaturan: pakai List. Pakai .lrow--icon dengan .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

Garis dan isiGaris sebagai bawaan; gaya isi menandai sesuatu yang terpilih atau menyala.
<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>
Ukuran16 untuk meta padat, 20 sebagai bawaan, 24 untuk header. Di dalam komponen ukurannya sudah diatur (19 di tombol, 22 di icon button, 14 di badge).
<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>
Di samping teksIkon dekoratif disembunyikan dari pembaca layar; kata-katalah yang membawa makna.
Disetujui Izin Anda berlaku setelah ditandatangani kepala dinas.
<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>
Berdiri sendiriSaat ikon adalah satu-satunya yang menyampaikan sesuatu (status di sel tabel), beri role dan nama alih-alih menyembunyikannya.
check_circle
<span class="ic ic--fill" role="img" aria-label="Terverifikasi" style="color: var(--success-text);">check_circle</span>

Anatomi

BagianFungsinya
.icWajib. <span> yang teksnya adalah nama ikon. 20 px, gaya garis, persegi 1em, tidak pernah turun baris.
.ic--fillGaya tebal (berisi) dari font kedua, untuk status terpilih dan berisi.
.ic--sm / .ic--lg16 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 atributKapan
ic--fillGaya tebal untuk status terpilih, tertekan, dan berisi. Toggle tertekan, ikon alert, chip ikon daftar, dan thumbnail petak berkas otomatis beralih ke gaya ini.
ic--sm16 px.
ic--lg24 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-fast sementara yang baru mendarat dengan --spring-snappy selama --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" dan aria-label dalam 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.json sebelum 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, dan user tampil kosong (namanya arrow_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.