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.

Nav progress

Nav progress

Bilah aksen setinggi 3 px di tepi atas jendela yang berjalan selama halaman berikutnya dimuat. Tambahkan .is-running saat navigasi dimulai, hapus saat halaman sudah tampil.

Penggunaan

Pakai saat

  • Navigasi sisi klien (single-page app atau router framework) yang halaman berikutnya bisa butuh lebih dari sekitar 300 ms untuk tiba.
  • Pergantian halaman penuh yang halaman lamanya tetap terlihat sampai halaman baru siap.

Pakai yang lain saat

  • Kemajuan tugas dengan persentase yang diketahui (unggah, impor): pakai Progress bar.
  • Satu area halaman yang sedang memuat isinya: pakai Skeleton. Tampilkan bentuk konten yang akan datang di tempatnya.
  • Tombol yang menunggu aksinya selesai: pakai Button. Pakai status loading pada tombol.
  • Menunggu balasan asisten: pakai Thinking.

Letaknya. Satu per aplikasi, menempel di atas viewport (position: fixed, z-index 90), di atas top bar atau app shell. Render sekali di root dan ubah kelasnya dari router.

Contoh

Membuka tahap berikutnyaBilah berjalan di tepi atas kotak ini selama "halaman" dimuat, lalu hilang. Di aplikasi, bilah berada di atas jendela.

Tahap 3 terbuka

<div class="navprogress" aria-hidden="true"></div>

<script type="module">
  const bar = document.querySelector('.navprogress');
  router.on('start', () => bar.classList.add('is-running'));
  router.on('done', () => bar.classList.remove('is-running'));
</script>

Anatomi

BagianFungsinya
.navprogressWajib. Elemen kosong (<div>), aria-hidden="true"; berskala 0 dan transparan saat diam.
.navprogress.is-runningTampil dan melebar perlahan menuju 85 % lebar selama navigasi berjalan.

Status

StatusCaranya
(idle)scaleX(0), transparan.
.is-runningMenjadi pekat dalam 80 ms, lalu melebar ke scaleX(0.85) selama 2,4 detik dengan kurva yang cepat di awal lalu melambat, sehingga pemuatan yang lambat tidak pernah tampak selesai.
(removed)Memudar selama 240 ms setelah jeda 120 ms dengan --ease-exit, sementara skala kembali ke 0 dalam 200 ms.

Gerak dan mikrointeraksi

  • Tumbuh dari kiri (transform-origin: 0 50%) hanya dengan transform: scaleX(), sehingga tidak pernah memicu layout.
  • Berjalan: scaleX(0.85) selama 2,4 detik dengan cubic-bezier(0.1, 0.7, 0.2, 1); opacity masuk 80 ms linear.
  • Selesai: menghapus .is-running mengembalikan skala ke 0 dalam 200 ms dengan --ease-standard dan memudarkannya selama 240 ms (jeda 120 ms) dengan --ease-exit. Tidak ada langkah "penuhkan ke 100 %" terpisah di CSS.
  • Mulai hanya jika navigasi masih berjalan setelah sekitar 150 ms, agar halaman yang cepat tidak memunculkan kedipan.
  • Reduced motion: bilah selebar penuh dan hanya muncul serta memudar (120 ms linear).

Aksesibilitas

  • Dekoratif: aria-hidden="true". Umumkan halaman baru dengan memindahkan fokus ke <h1> atau <main>, atau perbarui judul dokumen.
  • Jangan jadikan satu-satunya tanda pemuatan untuk sesuatu yang ditunggu di dalam halaman; di sana pakai skeleton atau tombol loading.

Lakukan dan hindari

Lakukan

  • Render tepat satu di root aplikasi.
  • Tunda awalnya sekitar 150 ms.

Hindari

  • Menampilkan spinner layar penuh di antara halaman.
  • Mengatur lebar dari persentase palsu lewat JavaScript.
  • Memakainya untuk unggahan atau tugas lain yang punya kemajuan nyata.

Perilaku dan kode

HTML biasa. Tidak ada; dikendalikan CSS. Ubah .is-running dari router Anda.