UnreviewedAny data-* attribute is forwarded to the rendered element.
Any aria-* attribute is forwarded to the rendered element.
Optional UnreviewedvalueCurrent progress value. Omit this prop, or pass false, to show
indeterminate progress. Negative values are clamped to 0.
Optional UnreviewedmaxUpper bound of the range.
Optional UnreviewedtoneColor variant, or any literal CSS color for a one-off custom tone (the surface / indicator / text are derived from it in oklch). Named tones track light/dark automatically.
Optional UnreviewedsizeSize variant. Scales the track and the default label row together.
Optional UnreviewedroundFully-round track (border-radius: 999px); the fill is clipped to it. Pass a
number (px) or a CSS length string for a custom radius.
Optional UnreviewedlabelText label displayed after the percentage, or on its own for
indeterminate progress. When you provide custom children (which replace
the default label row), label is no longer rendered — but it still
supplies the progressbar's accessible name.
Optional UnreviewedhintRight-aligned hint text (e.g. "3 of 7"). Like label, it's not rendered
when custom children are provided but still feeds the accessible name.
Optional UnreviewedclassCSS class on the component's root element (merged with the component's own
classes). Use it directly for layout and positioning — grid/flex placement,
margins, alignment — rather than wrapping the component in a <div>/<span>.
Optional UnreviewedstyleInline styles on the component's root element. Set layout/positioning here
(or via className) directly on the component instead of adding a wrapper.
Optional UnreviewedchildrenChild elements. When provided, replaces the component's default label/content.
Optional UnreviewedidHTML id attribute.
Optional UnreviewedtitleHTML title attribute — native browser tooltip on hover.
Optional UnreviewedslotAssigns the element to a named <slot> of a parent web component (e.g.
slot="header" inside a <Card>, slot="footer" inside a <Dialog>).
Optional UnreviewedtabTab order. Set to -1 to skip the element when tabbing.
Optional UnreviewedkeyReact/Preact reconciliation key when rendered inside a list. Consumed by the JSX runtime (not forwarded as a DOM attribute).
Common props for JSX component wrappers.