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.

Chart states

Chart states

Setiap grafik dirancang dalam state loading, kosong, dan error di dalam .chart-card yang sama, dengan ukuran yang sama seperti grafik yang sudah dimuat: skeleton berbentuk grafiknya sendiri, pesan kosong beserta alasannya, dan error dengan tombol coba lagi.

Penggunaan

Pakai saat

  • Grafik apa pun yang datanya berasal dari request: buat ketiga state ini sebelum grafik dirilis.
  • Rentang tanggal atau filter bisa menghasilkan data kosong, dan pembaca perlu tahu bahwa itu memang kosong, bukan rusak.

Pakai yang lain saat

  • State untuk daftar, tabel, atau halaman yang bukan grafik: pakai Data states.
  • Seluruh halaman sedang dimuat: pakai Nav progress.
  • Pembaruan latar untuk grafik yang sudah tampil: pakai Spinner. Pertahankan grafiknya dan tampilkan spinner kecil di dekat judul; jangan ganti dengan skeleton.
  • Kegagalan yang memengaruhi seluruh aplikasi: pakai Banner.

Letaknya. Menggantikan area plot, di dalam kartu grafik yang sama, yang mempertahankan min-height agar grid dasbor tidak bergeser. Judul dan subjudul tetap tampil pada state kosong dan error; saat loading keduanya juga berupa skeleton.

Contoh

Loading, kosong, errorGrafik batang yang sama dalam tiga state tanpa data, berdampingan dengan ukuran grafik aslinya.
Hari apa yang paling sibuk?
Laporan warga yang masuk per hari, minggu ini
Belum ada laporan minggu ini
Grafik terisi begitu laporan masuk.
Hari apa yang paling sibuk?
Laporan warga yang masuk per hari, minggu ini
<div class="auto-grid" style="--min: 260px;">
<div class="chart-card" style="min-height: 240px;" role="status" aria-busy="true" aria-label="Memuat grafik laporan warga">
  <div class="stack" style="--gap: 8px;"><div class="skel" style="height: 14px; width: 55%;"></div><div class="skel" style="height: 12px; width: 35%;"></div></div>
  <div style="display: flex; align-items: flex-end; gap: 8px; height: 140px;">
    <div class="skel" style="flex: 1; height: 40%;"></div><div class="skel" style="flex: 1; height: 70%;"></div><div class="skel" style="flex: 1; height: 55%;"></div><div class="skel" style="flex: 1; height: 85%;"></div><div class="skel" style="flex: 1; height: 30%;"></div><div class="skel" style="flex: 1; height: 20%;"></div><div class="skel" style="flex: 1; height: 12%;"></div>
  </div>
</div>
<div class="chart-card" style="min-height: 240px;">
  <div><div class="chart-card__q">Hari apa yang paling sibuk?</div><div class="chart-card__sub">Laporan warga yang masuk per hari, minggu ini</div></div>
  <div class="empty" style="padding: 16px 8px;">
    <div class="empty__title">Belum ada laporan minggu ini</div>
    <div class="empty__body">Grafik terisi begitu laporan masuk.</div>
    <button class="btn btn--secondary btn--sm">Lihat minggu lalu</button>
  </div>
</div>
<div class="chart-card" style="min-height: 240px;">
  <div><div class="chart-card__q">Hari apa yang paling sibuk?</div><div class="chart-card__sub">Laporan warga yang masuk per hari, minggu ini</div></div>
  <div class="alert alert--danger" role="alert">
    <span class="ic" aria-hidden="true">error</span>
    <div>
      <div class="alert__title">Data grafik gagal dimuat</div>
      <div class="alert__body">Layanan pengaduan tidak merespons tepat waktu.</div>
      <div class="alert__actions"><button class="btn btn--secondary btn--sm"><span class="ic" aria-hidden="true">refresh</span>Coba lagi</button></div>
    </div>
  </div>
</div>
</div>
Bentuk loading untuk grafik lainGrafik garis dimuat sebagai garis grid-nya, donut sebagai cincin, bar persentase sebagai satu strip.
<div class="auto-grid" style="--min: 220px;">
  <div class="chart-card" role="status" aria-busy="true" aria-label="Memuat kunjungan puskesmas">
    <div class="skel" style="height: 14px; width: 60%;"></div>
    <div class="stack" style="--gap: 30px; padding-top: 12px;"><div class="skel" style="height: 2px;"></div><div class="skel" style="height: 2px;"></div><div class="skel" style="height: 2px;"></div><div class="skel" style="height: 2px;"></div></div>
  </div>
  <div class="chart-card" role="status" aria-busy="true" aria-label="Memuat sebaran kategori laporan">
    <div class="skel" style="height: 14px; width: 60%;"></div>
    <div class="cluster" style="--gap: 20px;"><div class="skel" style="width: 120px; height: 120px; border-radius: 50%;"></div><div class="stack" style="--gap: 10px; flex: 1;"><div class="skel" style="height: 12px;"></div><div class="skel" style="height: 12px; width: 70%;"></div><div class="skel" style="height: 12px; width: 50%;"></div></div></div>
  </div>
  <div class="chart-card" role="status" aria-busy="true" aria-label="Memuat porsi pajak daerah">
    <div class="skel" style="height: 14px; width: 60%;"></div>
    <div class="skel" style="height: 14px; border-radius: 4px;"></div>
    <div class="skel" style="height: 12px; width: 80%;"></div>
  </div>
</div>

Anatomi

BagianFungsinya
.chart-card[role=status][aria-busy]Wadah loading, dengan aria-label yang menyebut nama grafiknya.
.skelLoading. Blok berbentuk grafiknya sendiri: batang untuk grafik batang, strip 14 px untuk bar persentase, lingkaran untuk donut, grid kotak untuk heatmap.
.emptyKosong. Judul menyebut apa yang tidak ada untuk periode mana, isi menjelaskan kapan terisi, satu aksi untuk mengubah rentang.
.alert.alert--dangerError. Apa yang gagal, lalu Coba lagi.

Status

StatusCaranya
loadingSkeleton berbentuk grafiknya, muncul setelah sekitar 300 ms. role="status" + aria-busy="true".
emptyPertahankan judul; .empty tanpa ikon (kartunya kecil) dan satu tombol untuk mengubah rentang.
error.alert--danger dengan role="alert" dan Coba lagi. Jika masih punya data lama, biarkan tetap tampil dengan .alert--warning di atasnya.
partial dataPlot data yang ada dan sebutkan yang hilang di subjudul ("Tidak ada data untuk minggu ke-7").

Gerak dan mikrointeraksi

  • Shimmer skeleton: 1,6 s dengan --ease-inout, berulang selama loading; dengan reduced motion hanya diputar sekali.
  • Saat data tiba, plot menggantikan skeleton dengan efek pudar selama --d-standard; garis lalu boleh tergambar sekali dengan .draw.
  • State kosong dan error muncul tanpa gerak.

Aksesibilitas

  • Loading: role="status", aria-busy="true", dan aria-label yang menyebut nama grafik. Hapus keduanya saat grafik tampil.
  • Error: role="alert" agar diumumkan sekali; setelah Coba lagi, pindahkan fokus ke kartu.
  • Kosong: teks biasa di dalam kartu; judul grafik tetap berupa node teks asli agar pembaca tahu grafik mana yang kosong.

Lakukan dan hindari

Lakukan

  • Pertahankan ukuran kartu yang sama di setiap state.
  • Sebutkan periodenya di pesan kosong.
  • Tawarkan satu aksi: ubah rentang, atau coba lagi.

Hindari

  • Menampilkan plot kosong dengan sumbu tanpa pesan.
  • Menggambar garis datar di nol saat data tidak ada.
  • Memakai spinner tunggal di tengah kartu grafik.