Skip to main content

Progress

Overview​

The Progress component displays a Bulma-styled progress bar. It supports color and size modifiers, value/max attributes, custom content, and all Bulma helper props for spacing and layout.

info

Use Progress for visualizing task completion, loading states, or quantitative user feedback.

Import​

import { Progress } from '@allxsmith/bestax-bulma';

Props​

PropTypeDefaultDescription
classNamestring—Additional CSS classes.
colorBulma color (e.g. 'primary', 'info', etc.)—Bulma color modifier for the progress bar.
size'small' | 'medium' | 'large'—Size modifier for the progress bar.
valuenumber—Current value of the progress bar.
maxnumber—Maximum value of the progress bar.
childrenReact.ReactNode—Optional custom content inside the progress bar.
...All standard <progress> and Bulma helper props(See Helper Props)

Usage​

Default Progress​

The default usage of the Progress component displays a horizontal progress bar. Set the value and max props to indicate completion percentage or progress toward a goal.

<Progress value={50} max={100} />

Colored Progress​

Set the color prop to visually distinguish different types of progress. Use color variants like primary, success, warning, danger, info, or link to match the context of the task or status.

<>
  <Progress color="primary" value={75} max={100} />
  <Progress color="success" value={90} max={100} />
  <Progress color="warning" value={30} max={100} />
  <Progress color="danger" value={10} max={100} />
  <Progress color="info" value={60} max={100} />
  <Progress color="link" value={80} max={100} />
</>

Sizing​

Adjust the size of the progress bar using the size prop. Options include small, medium, or large to fit the design requirements of your application.

<>
  <Progress size="small" value={50} max={100} />
  <Progress size="medium" value={50} max={100} />
  <Progress size="large" value={50} max={100} />
</>

With Margin​

Utilize Bulma's spacing helpers by adding margin props like m="4" to control the progress bar's margin. This example applies a margin of 4 units.

<Progress value={50} max={100} m="4" />

Indeterminate Progress​

For tasks with unknown progress, use the indeterminate state by omitting the value prop. This example shows a primary colored indeterminate progress bar.

<Progress color="primary" max={100} />

Custom Content​

The Progress component allows for custom content inside the progress bar. This example shows how to display text content indicating the completion percentage.

<Progress value={50} max={100}>
  50% Complete
</Progress>

Multiple Indeterminate​

Easily create multiple indeterminate progress bars with different sizes and colors. This example demonstrates a combination of small, medium, and large indeterminate bars.

<>
  <Progress className="is-small is-primary" max={100} />
  <Progress className="is-danger" max={100} />
  <Progress className="is-medium is-dark" max={100} />
  <Progress className="is-large is-info" max={100} />
</>

Accessibility​

  • Role: The <progress> element is natively accessible.
  • Labeling: Always provide context for screen readers (e.g., with aria-label or visible text).
  • Indeterminate: Omit the value prop for indeterminate progress bars.
warning

Ensure your progress bars have sufficient color contrast for users with visual impairments.

Additional Resources​