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.

Progress bar

Progress bar

Track 6 px yang terisi seiring tugas dengan ukuran yang diketahui berjalan. Tampilkan angkanya di samping; pakai bar indeterminate hanya jika benar-benar tidak bisa diukur.

Penggunaan

Pakai saat

  • Tugas dengan jumlah yang terukur sedang berjalan: unggahan, impor data, ekspor laporan, soal yang sudah dijawab dalam tryout.
  • Kemajuan dalam pelatihan atau modul, ditampilkan dengan angkanya ("12 dari 20 materi").
  • Langkah persiapan singkat yang tidak terukur, saat garis lebih cocok daripada spinner (.progress--indeterminate).

Pakai yang lain saat

  • Tile ringkas atau skor yang harus muat dalam kotak: pakai Progress ring.
  • Tingkat atau kapasitas, bukan tugas (penyimpanan terpakai, kekuatan kata sandi): pakai Meter.
  • Tunggu singkat tanpa angka, di dalam tombol atau baris: pakai Spinner.
  • Konten sedang dimuat dan tata letaknya diketahui: pakai Skeleton.
  • Pekerjaan panjang yang lamanya tidak diketahui, saat waktu berjalan adalah sinyal yang jujur: pakai Thinking.
  • Berkas yang diunggah ke drop zone: pakai Upload progress.
  • Langkah-langkah alur beberapa halaman: pakai Steps.
  • Bagian dari keseluruhan lintas kategori: pakai Percentage bar.
  • Halaman sedang dimuat setelah navigasi: pakai Nav progress.

Letaknya. Tepat di bawah hal yang diukurnya: di baris unggahan, di card pelatihan, di bawah header pekerjaan yang sedang berjalan. Dengan .progress-meta di atasnya untuk label dan angka. Selebar wadahnya di semua ukuran layar; jangan pernah sebagai strip selebar halaman (itu navigation progress).

Contoh

Determinate dengan angkanyaLabel menyebut apa yang sedang terjadi, angka menyebut sejauh mana. Tekan tombol untuk memajukannya.
Mengunggah denah-lokasi-usaha.pdf36%
<div class="progress-meta"><span id="up-l">Mengunggah denah-lokasi-usaha.pdf</span><b>64%</b></div>
<div class="progress" role="progressbar" aria-labelledby="up-l" aria-valuemin="0" aria-valuemax="100" aria-valuenow="64">
  <div class="progress__fill" style="transform: scaleX(0.64);"></div>
</div>
Kemajuan pelatihanHal yang dihitung lebih mudah dibaca sebagai "12 dari 20" daripada persentase. Bar tipis muat di dalam card dan baris list.
Pembukuan sederhana untuk UMKM
Modul 3: mencatat arus kas
Materi12 dari 20
<div class="card" style="max-width: 360px;">
  <div class="card__title">Pembukuan sederhana untuk UMKM</div>
  <div class="card__sub">Modul 3: mencatat arus kas</div>
  <div style="margin-top: 16px;">
    <div class="progress-meta"><span>Materi</span><b>12 dari 20</b></div>
    <div class="progress progress--thin" role="progressbar" aria-label="Materi selesai" aria-valuemin="0" aria-valuemax="20" aria-valuenow="12" aria-valuetext="12 dari 20 materi"><div class="progress__fill" style="transform: scaleX(0.6);"></div></div>
  </div>
</div>
IndeterminateSatu segmen menyapu selama lamanya belum diketahui. Pasangkan dengan kata-kata yang memberi gambaran waktu.
Menyiapkan surat keterangan AndaBiasanya kurang dari satu menit
<div style="max-width: 420px; width: 100%;">
  <div class="progress-meta"><span>Menyiapkan surat keterangan Anda</span><span>Biasanya kurang dari satu menit</span></div>
  <div class="progress progress--thin progress--indeterminate" role="progressbar" aria-label="Menyiapkan surat keterangan Anda"><div class="progress__fill"></div></div>
</div>
SelesaiDi 100 % isian boleh berubah ke warna success; tulis juga "Selesai" dengan kata-kata.
Laporan dieksporSelesai
<div style="max-width: 420px; width: 100%;">
  <div class="progress-meta"><span>Laporan diekspor</span><b>Selesai</b></div>
  <div class="progress" role="progressbar" aria-label="Ekspor laporan" aria-valuemin="0" aria-valuemax="100" aria-valuenow="100"><div class="progress__fill" style="transform: scaleX(1); background: var(--success);"></div></div>
</div>

Anatomi

BagianFungsinya
.progressWajib. Track-nya: tinggi 6 px, membulat, di atas --bg-track. Membawa role="progressbar".
.progress__fillWajib. Isiannya, blok yang membesar dari kiri. Atur transform: scaleX(0.64) untuk 64 %.
.progress-metaBaris opsional di atas bar: label di kiri, nilai dalam <b> di kanan (angka tabular).

Varian dan ukuran

Kelas atau atributKapan
progress6 px. Tugas mandiri dan unggahan.
progress--thin4 px. Di dalam card, baris list dan tata letak yang rapat.
progress--indeterminateSegmen 40 % menyapu setiap 1,4 detik. Hanya jika besar pekerjaannya tidak diketahui.
progress-metaBaris label dan nilai di atas bar.

Status

StatusCaranya
in progresstransform: scaleX(value) pada isian plus aria-valuenow pada bar.
indeterminate.progress--indeterminate tanpa aria-valuenow.
donescaleX(1), opsional background: var(--success) pada isian, dan "Selesai" di meta.
failedBiarkan isian di titik berhentinya, warnai var(--danger) dan tulis alasan serta tombol coba lagi di alert atau di barisnya.

Gerak dan mikrointeraksi

  • Isian bergerak dengan transform: scaleX() memakai --ease-inout selama --d-considered (480 ms): karena sudah ada di layar, kedua ujungnya diperhalus. Perubahan warna latar selama --d-standard.
  • Karena ini transition, pembaruan cepat berganti target dengan mulus; jangan memperlambat nilai agar terlihat sibuk dan jangan pernah memalsukan kemajuan yang macet di 90 %.
  • Indeterminate: lds-indeterminate, 1,4 detik dengan --ease-inout, tanpa henti. Dengan reduced motion loop hanya diputar sekali, jadi pasangkan dengan kata-kata.
  • Animasikan transform saja, jangan pernah width, agar pembaruan tetap di compositor.

Aksesibilitas

  • role="progressbar" dengan aria-valuemin, aria-valuemax dan aria-valuenow; beri nama dengan aria-labelledby yang menunjuk label meta, atau aria-label.
  • Pakai aria-valuetext jika angka mentah bukan bacaan paling jelas ("12 dari 20 materi", "Sekitar 2 menit lagi").
  • Bar indeterminate tidak memakai aria-valuenow.
  • Jangan mengumumkan setiap perubahan. Umumkan akhirnya sekali, dengan toast atau baris role="status".

Lakukan dan hindari

Lakukan

  • Tampilkan angka atau hitungan di samping bar.
  • Pakai kemajuan yang nyata; jika hanya tahu langkahnya, tampilkan langkah.
  • Letakkan bar di tempat hasilnya akan muncul, agar perhatian sudah di sana saat selesai.

Hindari

  • Menganimasikan width atau memakai isian gradien buatan.
  • Memakai bar indeterminate untuk pekerjaan yang bisa diukur.
  • Memakai progress bar untuk nilai yang bukan tugas (penyimpanan, kekuatan): itu meter.

Perilaku dan kode

HTML biasa. Tidak ada. Atur transform: scaleX() pada .progress__fill dan aria-valuenow pada .progress dari kode Anda.