FeedbackInteractive playground
Progress
Show how much of a task is complete.
Preparing the playground…
Text and Markdown example
Progress · Example
1<Progress value={65} max={100} aria-label="Project progress" style={{width:320}} />How to use it
Use a value between 0 and max. Progress must represent real data; do not use it as a simulated timer.
Import
React / Next.js
1import { Progress } from "@kivora/nextjs";Interactive examples run inside a component with "use client". The playground's Copy button includes the imports needed for the current example.
API reference 0.2.0
Types from the installed published version, including component properties and common HTML attributes. “Optional” does not imply a default value; omitting a property lets the component decide.
| Property | Type | Description |
|---|---|---|
aria-label | string | Accessible name of the control. |
asChild | boolean | Apply props and behavior to a single compatible child element. |
children | ReactNode | Content or child elements of the component. |
className | string | Additional CSS classes to customize the element. |
defaultChecked | boolean | Initial selection of the control. |
defaultValue | string | number | readonly string[] | Initial value when the component manages its own state. |
getValueLabel | ((value: number, max: number) => string) | Configures getValueLabel. The type describes the supported values and structure. |
id | string | Element identifier; associates labels and descriptions. |
indicatorClassName | string | CSS classes for the specified element. |
max | number | Maximum allowed value. |
onChange | ChangeEventHandler<HTMLDivElement, Element> | Change event. Check the type: some controls return an object, others a DOM event. |
onClick | MouseEventHandler<HTMLDivElement> | Action performed when the element is activated. |
onSubmit | SubmitEventHandler<HTMLDivElement> | Form submission event. |
role | AriaRole | Semantic role of the element. Keep the default role unless a change is justified. |
size | "default" | "sm" | "lg" | Visual size of the component. |
style | CSSProperties | React inline styles. |
tabIndex | number | Keyboard focus order and availability. |
title | string | Title or supplementary information. |
value | number | null | Controlled value. Update it from the change callback. |
TypeScript definition
Review each component's properties and published declaration. Native and accessibility attributes are inherited from the element specified by its type.
Progress19 properties
Progress · TypeScript
1Progress: React.ForwardRefExoticComponent<ProgressProps & React.RefAttributes<HTMLDivElement>>API generated from @kivora/nextjs 0.2.0View package