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.

Data states

Data states

Setiap tampilan yang menampilkan data dirancang dalam empat status: memuat, kosong, galat, dan termuat. Setiap status memakai ulang komponen yang sudah ada (skel, empty, alert) dan menjaga ukuran yang sama, sehingga halaman tidak melompat di antaranya.

Penggunaan

Pakai saat

  • Daftar, tabel, grafik, grid kartu, atau panel detail apa pun yang isinya berasal dari permintaan data: rancang keempat status sebelum dirilis.
  • Tampilan memang bisa tidak punya data (akun baru, filter tanpa hasil, minggu yang sepi) dan perlu menjelaskan alasannya serta menawarkan satu aksi yang mengisinya.
  • Permintaan bisa gagal dan orang perlu tahu apa yang gagal dan cara mencoba lagi, tanpa kehilangan apa yang sudah mereka lihat.

Pakai yang lain saat

  • Tombol yang sibuk setelah ditekan: pakai Button. Pakai status .is-loading-nya; jangan ganti tampilan dengan skeleton.
  • Seluruh halaman memuat setelah navigasi: pakai Nav progress.
  • Menunggu asisten atau komputasi panjang dengan timer yang jujur: pakai Thinking.
  • Progres dengan persentase yang diketahui (unggah, impor): pakai Progress bar.
  • Kegagalan yang menyangkut seluruh aplikasi (offline, pemeliharaan): pakai Banner.
  • Hasil yang sudah terjadi dan tidak perlu tindakan lanjut: pakai Toast.

Letaknya. Setiap status mengisi tepat area yang akan diisi konten termuat: kotak daftar, isi tabel, kartu grafik. Bingkai halaman (judul, filter, tab) tetap di tempat dan tetap bisa dipakai. Di ponsel aturannya sama; status kosong berada di tempat baris pertama akan muncul.

Contoh

Keempat statusDaftar permohonan yang sama di setiap status. Beralih di antaranya: kotak tetap di tempat dan kontrol di atasnya tetap bisa dipakai.
<!-- loading -->
<div class="list" role="status" aria-busy="true" aria-label="Memuat permohonan">
  <div class="lrow"><span class="lrow__body"><span class="skel" style="display: block; height: 14px; width: 62%;"></span><span class="skel" style="display: block; height: 11px; width: 37%; margin-top: 8px;"></span></span><span class="skel" style="width: 64px; height: 22px; border-radius: 6px;"></span></div>
  <div class="lrow"><span class="lrow__body"><span class="skel" style="display: block; height: 14px; width: 48%;"></span><span class="skel" style="display: block; height: 11px; width: 23%; margin-top: 8px;"></span></span><span class="skel" style="width: 64px; height: 22px; border-radius: 6px;"></span></div>
  <div class="lrow"><span class="lrow__body"><span class="skel" style="display: block; height: 14px; width: 55%;"></span><span class="skel" style="display: block; height: 11px; width: 30%; margin-top: 8px;"></span></span><span class="skel" style="width: 64px; height: 22px; border-radius: 6px;"></span></div>
</div>

<!-- empty -->
<div class="list list--fill">
  <div class="empty">
    <div class="empty__icon"><span class="ic" aria-hidden="true">event_available</span></div>
    <div class="empty__title">Tidak ada berkas jatuh tempo minggu ini</div>
    <div class="empty__body">Permohonan baru muncul di sini begitu warga mengirimkannya.</div>
    <button class="btn btn--secondary btn--md">Buka kalender lengkap</button>
  </div>
</div>

<!-- error -->
<div class="alert alert--danger" role="alert">
  <span class="ic" aria-hidden="true">error</span>
  <div>
    <div class="alert__title">Permohonan gagal dimuat</div>
    <div class="alert__body">Layanan perizinan tidak menjawab tepat waktu. Data Anda tetap aman.</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>

<!-- loaded -->
<div class="list">
  <div class="lrow"><span class="lrow__body"><span class="lrow__title" style="display: block;">Izin usaha mikro</span><span class="lrow__sub" style="display: block;">UMKM Sukarame · jatuh tempo besok</span></span><span class="badge badge--warning">Besok</span></div>
  <div class="lrow"><span class="lrow__body"><span class="lrow__title" style="display: block;">Izin keramaian</span><span class="lrow__sub" style="display: block;">Kelurahan Kedaton · jatuh tempo Kamis</span></span><span class="badge">Kam</span></div>
  <div class="lrow"><span class="lrow__body"><span class="lrow__title" style="display: block;">Surat keterangan domisili</span><span class="lrow__sub" style="display: block;">Kecamatan Way Halim · jatuh tempo Jumat</span></span><span class="badge">Jum</span></div>
</div>
Kosong karena filterJika filter yang menyebabkan hasil kosong, katakan begitu dan tawarkan untuk menghapusnya, bukan membuat sesuatu.
Tidak ada layanan yang cocok dengan filter ini
Tidak ada layanan yang buka di Kecamatan Rajabasa dengan waktu proses kurang dari 3 hari.
<div class="list list--fill" style="max-width: 520px;">
  <div class="empty">
    <div class="empty__icon"><span class="ic" aria-hidden="true">filter_list</span></div>
    <div class="empty__title">Tidak ada layanan yang cocok dengan filter ini</div>
    <div class="empty__body">Tidak ada layanan yang buka di Kecamatan Rajabasa dengan waktu proses kurang dari 3 hari.</div>
    <button class="btn btn--secondary btn--md">Hapus filter</button>
  </div>
</div>
Galat yang mempertahankan data lamaPenyegaran gagal tetapi baris yang terakhir dimuat masih berguna: pertahankan dan taruh alert di atasnya.
Menampilkan data pukul 09.40
Daftar permohonan tidak bisa diperbarui. Periksa koneksi Anda lalu coba lagi.
Izin usaha mikroUMKM Sukarame · jatuh tempo besokBesok
Izin keramaianKelurahan Kedaton · jatuh tempo KamisKam
Surat keterangan domisiliKecamatan Way Halim · jatuh tempo JumatJum
<div class="stack" style="--gap: 12px; max-width: 520px;">
  <div class="alert alert--warning" role="status">
    <span class="ic" aria-hidden="true">sync_problem</span>
    <div>
      <div class="alert__title">Menampilkan data pukul 09.40</div>
      <div class="alert__body">Daftar permohonan tidak bisa diperbarui. Periksa koneksi Anda lalu coba lagi.</div>
      <div class="alert__actions"><button class="btn btn--secondary btn--sm"><span class="ic" aria-hidden="true">refresh</span>Perbarui</button></div>
    </div>
  </div>
  <div class="list">
  <div class="lrow"><span class="lrow__body"><span class="lrow__title" style="display: block;">Izin usaha mikro</span><span class="lrow__sub" style="display: block;">UMKM Sukarame · jatuh tempo besok</span></span><span class="badge badge--warning">Besok</span></div>
  <div class="lrow"><span class="lrow__body"><span class="lrow__title" style="display: block;">Izin keramaian</span><span class="lrow__sub" style="display: block;">Kelurahan Kedaton · jatuh tempo Kamis</span></span><span class="badge">Kam</span></div>
  <div class="lrow"><span class="lrow__body"><span class="lrow__title" style="display: block;">Surat keterangan domisili</span><span class="lrow__sub" style="display: block;">Kecamatan Way Halim · jatuh tempo Jumat</span></span><span class="badge">Jum</span></div>
</div>
</div>

Anatomi

BagianFungsinya
.skelMemuat. Blok berbentuk seperti konten asli (tinggi baris sama, lebar judul dan meta sama), berkilau. Lihat skeleton.
.emptyKosong. .empty__icon + .empty__title (apa yang kosong) + .empty__body (mengapa, dan apa yang mengisinya) + satu tombol. Lihat empty state.
.alert.alert--dangerGalat. Apa yang gagal dalam kata sederhana, bahwa tidak ada yang hilang, dan tombol coba lagi di .alert__actions. Lihat alert.
role="status" aria-busy="true"Pada kontainer yang memuat, agar teknologi bantu tahu area itu sedang diperbarui.

Status

StatusCaranya
loadingSkeleton yang meniru tata letak termuat, di dalam role="status" aria-busy="true". Tampilkan hanya setelah sekitar 300 ms; respons cepat langsung ke termuat.
empty.empty dengan ikon, judul yang menyebut apa yang kosong, satu kalimat alasan, dan satu aksi yang mengisinya (atau menghapus filter).
error.alert--danger dengan role="alert": apa yang gagal, bahwa tidak ada yang hilang, dan Coba lagi. Jika ada data lama, pertahankan dan pakai .alert--warning di atasnya.
loadedKonten asli. Hapus aria-busy dan role status saat data tiba.

Gerak dan mikrointeraksi

  • Kilau skeleton: pita terang melintasi setiap .skel dalam 1,6 detik dengan --ease-inout, berulang selama memuat. Dengan reduced motion ia berjalan sekali dan blok tetap diam.
  • Konten termuat menggantikan skeleton dengan fade dalam --d-standard dengan --ease-enter; daftar boleh datang dengan list stagger (berjarak 35 ms, total di bawah 400 ms). Jangan pernah menganimasikan ukuran kotak.
  • Galat dan status kosong muncul tanpa gerak; mereka adalah jawaban, bukan peristiwa.

Aksesibilitas

  • Area memuat: role="status", aria-busy="true", dan aria-label ("Memuat permohonan"). Blok skeleton adalah elemen kosong, jadi tidak ada lagi yang dibacakan.
  • Galat yang menghalangi tugas memakai role="alert" agar diumumkan sekali; peringatan data lama memakai role="status".
  • Setelah Coba lagi, kembalikan fokus ke dalam area (baris pertama atau alert) agar pengguna keyboard tidak tertinggal di tombol yang sudah dihapus.
  • Judul status kosong berupa teks biasa, bukan heading, kecuali area itu adalah bagian halaman dengan heading sendiri.

Lakukan dan hindari

Lakukan

  • Bentuk skeleton seperti konten asli: jumlah baris di layar sama, tinggi sama.
  • Tulis status kosong sebagai jawaban: apa yang kosong, mengapa, dan satu aksinya.
  • Biarkan data lama terlihat saat penyegaran gagal.

Hindari

  • Menampilkan spinner sendirian di tengah kotak kosong untuk konten yang bentuknya sudah diketahui.
  • Menulis "Tidak ada data" atau "Terjadi kesalahan" tanpa alasan dan tanpa langkah berikutnya.
  • Mengganti kontrol halaman (filter, tab, pencarian) dengan skeleton; hanya area data yang memuat.

Perilaku dan kode

HTML biasa. Tidak wajib. Ganti status dari lapisan data Anda. toast() untuk hasil aksi, bukan untuk galat pemuatan.

React. Dari lampung-design-system/react.

import { Alert } from 'lampung-design-system/react';

if (status === 'loading') return <div className="list" role="status" aria-busy="true" aria-label="Memuat permohonan">{/* .skel rows */}</div>;
if (status === 'error') return <Alert tone="danger" title="Permohonan gagal dimuat" actions={<button className="btn btn--secondary btn--sm" onClick={retry}>Coba lagi</button>}>Layanan perizinan tidak menjawab tepat waktu.</Alert>;
if (items.length === 0) return <div className="empty">{/* icon, title, body, one action */}</div>;