Community project. This is not an official government website.

Run by volunteers. Lampung Design System is built by an open source community. No government agency runs or endorses it.

Official services use go.id. Government websites in Indonesia end in .go.id. Never enter your national ID number on a site you are unsure of.

Upload progress

Upload progress

An upload traces its progress around the edge of the drop zone it was dropped on, with a percent pill in the corner. The line turns green at 100 %. The number is real; it never crawls toward 90 % and waits.

Usage

Use it when

  • A file is uploading into a drop zone (file input) and the size is known, so a real percentage exists.
  • One large file where the wait is long enough to matter: a thesis, a recorded lecture, a scanned answer sheet.

Use something else when

  • Several files at once: use File input. Show a progress bar inside each .file-row instead.
  • Progress that is not an upload: use Progress bar.
  • Work with no known length: use Thinking.
  • A course or task completion figure: use Progress ring.

Where it goes. On the .drop zone the file went into. The pill sits in its top right corner; the trace follows its rounded edge.

Examples

Upload a thesisPress Upload. The line runs around the edge as bytes arrive and the pill counts; at 100 % both turn green.
thesis-final.pdf4.2 MB
import { uploadProgress, uploadReset } from 'lampung-design-system/js';

xhr.upload.onprogress = (e) => uploadProgress(drop, (e.loaded / e.total) * 100);
// to start over: uploadReset(drop)
An upload that stopsThis one fails halfway: the trace disappears, the zone shakes, and the reason replaces the size in words, with a way to try again.
lecture-6.mp44.2 MB
<div class="drop" style="max-width: 420px;"><span class="ic" aria-hidden="true">cloud_upload</span><span class="card__title">lecture-6.mp4</span><span class="card__sub">4.2 MB</span><button class="btn btn--secondary btn--sm" style="margin-top: 6px;" onclick="const drop = this.closest('.drop'); const meta = drop.querySelector('.card__sub'); this.disabled = true; import('../../js/lds.js').then((m) => { m.uploadReset(drop); let p = 0; const t = setInterval(() => { p += 7 + Math.random() * 9; if (p > 55) { clearInterval(t); m.uploadReset(drop); meta.textContent = 'Upload stopped at 58 %. Check your connection and try again.'; meta.classList.add('field__help--error'); this.disabled = false; this.textContent = 'Try again'; m.shake(drop); return; } m.uploadProgress(drop, Math.min(p, 100)); meta.textContent = Math.round(Math.min(p, 100) * 0.042 * 10) / 10 + ' of 4.2 MB'; if (p >= 100) { clearInterval(t); meta.textContent = 'Uploaded, 4.2 MB'; this.disabled = false; this.textContent = 'Upload again'; } }, 220); });">Upload</button></div>

Anatomy

PartWhat it is
.dropRequired. The drop zone.
.drop__ringSVG rect with pathLength="100" drawn over the edge (created by JS).
.drop__pctThe percent pill, role="progressbar" with aria-valuenow (created by JS).
.is-uploading / .is-completeSet by uploadProgress().

Motion and microinteractions

  • Trace: stroke-dasharray: <percent> 200 on a rect with pathLength="100", transitioning over 200 ms linear between updates, so it moves at the real speed of the upload.
  • Pill: appears from 10 px above with a 2 px blur (opacity 160 ms, transform 300 ms on --spring-snappy) when the upload starts.
  • Complete: the trace and pill cross-fade to green over --d-standard; a success haptic plays.
  • The ring fades in and out over 300 ms on --ease-standard when the upload starts or resets.
  • Reduced motion: the trace and pill still update (they report progress), each change in 120 ms.

Accessibility

  • The pill is role="progressbar" with aria-valuemin, aria-valuemax, aria-valuenow and aria-label="Upload progress".
  • Say the result in words when it ends ("Uploaded, 4.2 MB") and the reason when it fails.
  • Color is not the only completion signal: the pill reads 100 % and the text changes.

Do and don't

Do

  • Feed it real percentages from the upload events.
  • Replace the size line with the result or the reason at the end.
  • Call uploadReset before a new upload.

Don't

  • Fake progress on a timer.
  • Hold at 99 % while the server processes; switch the label to "Processing" with a thinking row.
  • Use it for several files at once.

Behavior and code

Plain HTML. uploadProgress(drop, percent) creates the ring and pill on first call, updates both, toggles .is-uploading and .is-complete (with a success haptic at 100). uploadReset(drop) removes both states.