Active theme set to LightDarkLight high contrastDark high contrast and saved in preferences.
Copied to clipboard.
Error submitting your feedback! Please try again.
We’re hiring frontend developers! View open positions.

Progress BarReady

Progress Bar is used to visually represent the completion of a task or process. It shows how much of the task has been completed and how much is still left.

Edit in CodePen
Open in new window
Edit in CodePen
Open in new window
Edit in CodePen
Open in new window
Edit in CodePen
Open in new window
Edit in CodePen
Open in new window
View RTL
<nord-progress-bar value="40"></nord-progress-bar>

Properties

PropertyAttributeDescriptionTypeDefault
valuevalue

Specifies how much of the task has been completed. Must be a valid floating point number between 0 and max, or between 0 and 100 if max is omitted. If there is no value, the progress bar is indeterminate; this indicates that an activity is ongoing with no indication of how long it’s expected to take.

number | undefinedundefined
maxmax

Describes how much work the task indicated by the progress element requires. The max attribute, if present, must have a value greater than 0 and be a valid floating point number.

number100
labellabel

Accessible label for the progress indicator. Visually hidden, but shown for assistive technology.

string"Current progress"

Methods

Method nameParametersDescription
focus(options?: FocusOptions) => voidoptions: An object which controls aspects of the focusing process.
Programmatically move focus to the component.
blur() => voidN/AProgrammatically remove focus from the component.
click() => voidN/AProgrammatically simulates a click on the component.

CSS Properties

CSS Custom Properties provide more fine grain control over component presentation. We advise utilizing existing properties on the component before using these.

PropertyDescriptionDefault
--n-progress-size

Controls the thickness of the progress bar, using our spacing tokens.

var(--n-space-s)
--n-progress-border-radius

Controls how rounded the corners are, using border radius tokens.

var(--n-border-radius-s)
--n-progress-color

Controls the color of the progress bar, using color tokens.

var(--n-color-accent)

Usage #

This section includes guidelines for designers and developers about the usage of this component in different contexts.

Do #

  • Use to show the completion status of an ongoing task.
  • Use progress bar when you can determine the percentage of the completed task at any time.
  • Always provide an accessible label when using Progress Bar.

Don’t #

  • Don’t use in constrained spaces indicating indeterminate loading state, see Spinner instead.

Integration

For integration guidelines, please see Web Components documentation. This documentation explains how to implement and use Nord Web Components across different technologies such as Vue.js, React, or Vanilla JavaScript.

Integration Guidelines

Localization

Nord provides a lightweight solution for localizing its components. Not all components need localizing, as for the most part snippets of text are set per instance. For full localization guidelines, please see Localization documentation.

Localization Guidelines

Troubleshooting

If you experience any issues while using Nord Web Components, please head over to the Support page for more guidelines and ways to contact us.


Was this page helpful?

YesNo
Send feedback

We use this feedback to improve our documentation.