component

Progress

props · 13 shown · 13 total

State

  • boolean
    default false

    Force indeterminate state regardless of the `value` prop. Useful when you explicitly want indeterminate behaviour even while a value is available.

  • number
    default 100

    Maximum value. The percentage is computed as `value / max`.

  • number

    Current progress value. Omitting this (without passing `indeterminate`) infers an indeterminate state.

Appearance

  • boolean
    default false

    Render a visible percentage label next to the indicator. Hidden when the progress is indeterminate.

  • "lg" "md" "sm" "xs"
    default "md"

    Controls bar height (linear) or ring diameter (circular), and scales the label font size.

  • "cyan" "danger" "dynamic" "mauve" "neutral" "pink" "primary" "sage" "slate" "stone" "success" "teal" "violet" "warning"
    default "primary"

    Semantic color role applied to the indicator. Use `neutral`, `success`, `warning`, or `danger` to convey meaning.

  • "linear" "circular"
    default "linear"

    Visual shape. `linear` renders a horizontal bar using a native `<progress>` element. `circular` renders an SVG ring with `role="progressbar"`.

Behavior

  • (value: number, max: number) => string

    Custom label formatter. Receives the clamped value and max; return any string. Only called when `showLabel` is true and the state is not indeterminate.

Accessibility

  • string

    Accessible label text passed as `aria-label` to the native `<progress>` (linear) or SVG progressbar (circular).

Slots

  • children slot svelte
    Snippet

    Optional extra content rendered inside the progress wrapper.

Advanced

  • element binding svelte
    HTMLDivElement null

    Bound reference to the root element (`bind:this`).

  • ProgressPassThrough< RootElementAttributes, TrackElementAttributes, IndicatorElementAttributes, LabelElementAttributes >

    Per-slot style and attribute override bag (root, track, indicator, label). `style` accepts a Panda CSS `SystemStyleObject`; `props` forwards arbitrary HTML or SVG attributes.

  • boolean
    default false

    Astro / vanilla: serialize the props into `data-progress-config` so the client runtime hydrates this instance and `getPindoba(el, "progress")` can `update()` it. Frameworks with their own reactivity don't need it.

Plus all standard <div> HTML attributes.

Type

  • Components
  • Blocks