📊 Progress Indicator — Documentation

🧭 When to Use / When Not to Use

Use When

• You need to show progress toward completion of a task.
• A process takes more than a few seconds (upload, download, processing).
• Users need clear feedback about how far they are in a flow.
• The UI requires either determinate progress (e.g., 45%) or indeterminate motion.

Avoid When

• The task is nearly instantaneous → use no progress indicator or a spinner.
• Users don’t need progress feedback → avoid visual noise.
• You need to show system status only → use a loading spinner, not a bar.
• The action does not have a measurable progression.

🎨 Considerations

Placement & Communication

• Place progress indicators close to the related action (upload section, form, modal).
• If progress represents a full page workflow, use label + percentage for clarity.

Label & Percentage Behavior

• Optional: show either or both
  • Label (e.g., “Uploading files…”)
  • Percentage (e.g., “45%”)