Feedback/DSProgressBar

DSProgressBar

feedback
since 0.1.0

Linear progress indicator with an optional label and percentage display. Supports indeterminate (loading) mode.

iOS 17+macOS 14+watchOS 10+tvOS 17+visionOS 1+

Purpose

Task completion, upload progress, onboarding steps, and loading states.

Interactive Reference

Live showroom

Need the full visual surface?

Screenshots do not scale well across every component, state, and variant. For the real interactive reference, import the package and launch DSShowcaseRoot().

Best for exploring:

variants, states, categories, and real app examples in one place.

Props

PropTypeDefaultDescription
valuereqDoubleโ€”Current progress, relative to total.
totalDouble1.0Value that represents 100%.
labelString?nilLabel above the bar.
showPercentageBoolfalseShows the percentage on the right.
tintColor?nilFill color. nil uses the theme primary.
heightCGFloat8Bar thickness.
animatedBooltrueAnimates value changes.

Examples

File upload progress

Bytes uploaded out of the file size.

swift
DSProgressBar(
    value: uploadedBytes,
    total: fileSize,
    label: "Uploading...",
    showPercentage: true
)

Related Components