Back to Progress Tracker-guidelines

CSS ComponentThe latest version of this package is: 17.0.30-alpha.0, Opens in new window

The progress tracker is meant to show the user where the user is in a process that requires multiple steps

This component provides .css, .styl, .less and .scss -files.

To be able to install this component, please refer to the Project Setup documentation.

View repository, Opens in new windowView package, Opens in new window
$ npm i @ids-core/progress-tracker@17.0.30-alpha.0
  1. Step titleHelpful text
  2. Step titleHelpful text
  3. Step titleHelpful text
  4. A longer step titleHelpful text
  5. Step titleHelpful text

Table of Contents

Edit this section, Opens in new window

Usage

Determinate

  1. Step titleHelpful text
  2. Step titleHelpful text
  3. Step titleHelpful text
  4. A longer step titleHelpful text
  5. Step titleHelpful text
<ol class="if progress-tracker">
  <li class="if is-complete">
    <span class="if title">Step title</span>
    <span class="if description">Helpful text</span>
  </li>
  <li class="if is-complete">
    <span class="if title">Step title</span>
    <span class="if description">Helpful text</span>
  </li>
  <li class="if is-current">
    <span class="if title">Step title</span>
    <span class="if description">Helpful text</span>
  </li>
  <li class="if">
    <span class="if title">A longer step title</span>
    <span class="if description">Helpful text</span>
  </li>
  <li class="if">
    <span class="if title">Step title</span>
    <span class="if description">Helpful text</span>
  </li>
</ol>
  1. Step titleHelpful text
  2. Step titleHelpful text
  3. Step titleHelpful text
  4. A longer step titleHelpful text
  5. Step titleHelpful text
<ol class="if progress-tracker vertical">
  <li class="if is-complete">
    <span class="if title">Step title</span>
    <span class="if description">Helpful text</span>
  </li>
  <li class="if is-complete">
    <span class="if title">Step title</span>
    <span class="if description">Helpful text</span>
  </li>
  <li class="if is-current">
    <span class="if title">Step title</span>
    <span class="if description">Helpful text</span>
  </li>
  <li class="if">
    <span class="if title">A longer step title</span>
    <span class="if description">Helpful text</span>
  </li>
  <li class="if">
    <span class="if title">Step title</span>
    <span class="if description">Helpful text</span>
  </li>
</ol>

Indeterminate

Helpful textStep titleCurrent step title
<div class="if progress-tracker indeterminate block">
  <div class="if container">
    <span class="if description">Helpful text</span>
    <span class="if title">Step title</span>
    <span class="if axe sr-only" id="progress-tracker-indeterminate-label-1">Current step title</span>
  </div>
  <progress
    class="if"
    tabindex="0"
    aria-labelledby="progress-tracker-indeterminate-label-1"
    max="100"
    value="50"
    aria-valuenow="50"
    aria-valuemin="0"
    aria-valuemax="100"
  ></progress>
</div>

The progress accepts a range from 0 to 100, and this value should be applied with JavaScript.

Accessibility

As the percentage of completion changes, be sure to update the aria-valuenow property on the progress bar.

<div class="if progress-tracker indeterminate block">
  <div class="if container">
    <span class="if description">Helpful text</span>
    <span class="if title">Step title</span>
    <span class="if axe sr-only" id="progress-tracker-indeterminate-label-1">Current step title</span>
  </div>
  <progress
    class="if"
    tabindex="0"
    aria-labelledby="progress-tracker-indeterminate-label-1"
    max="100"
    value="50"    aria-valuenow="50"    aria-valuemin="0"
    aria-valuemax="100"
  ></progress>
</div>

Small

  1. Step titleHelpful text
  2. Step titleHelpful text
  3. Step titleHelpful text
  4. A longer step titleHelpful text
  5. Step titleHelpful text
<ol class="if progress-tracker small">
  <li class="if is-complete">
    <span class="if title">Step title</span>
    <span class="if description">Helpful text</span>
  </li>
  <li class="if is-complete">
    <span class="if title">Step title</span>
    <span class="if description">Helpful text</span>
  </li>
  <li class="if is-current">
    <span class="if title">Step title</span>
    <span class="if description">Helpful text</span>
  </li>
  <li class="if">
    <span class="if title">A longer step title</span>
    <span class="if description">Helpful text</span>
  </li>
  <li class="if">
    <span class="if title">Step title</span>
    <span class="if description">Helpful text</span>
  </li>
</ol>
Edit this section, Opens in new window

Tokens

All of the tokens can be used as preprocessor and CSS variables

Progress Tracker tokens

Name Value Is aliased in
$ids-progress-tracker-height-indeterminate
 5rem
$ids-progress-tracker-description-font-size-indeterminate
 1.125rem
$ids-progress-tracker-description-line-height-indeterminate
 1.75rem
$ids-progress-tracker-description-color-indeterminate
 rgb(110, 98, 94)
$ids-progress-tracker-description-color-default
 rgb(110, 98, 94)
$ids-progress-tracker-description-color-current
 rgb(51, 30, 17)
$ids-progress-tracker-description-color-complete
 rgb(110, 98, 94)
$ids-progress-tracker-progress-height-indeterminate
 0.25rem
$ids-progress-tracker-progress-background-color-indeterminate
 rgb(232, 224, 217)
$ids-progress-tracker-progress-background-color-default
 rgb(110, 98, 94)
$ids-progress-tracker-progress-background-color-current
 transparent
$ids-progress-tracker-progress-background-color-complete
 rgb(0, 84, 240)
$ids-progress-tracker-progress-size-default
 0.25rem
$ids-progress-tracker-progress-size-vertical
 0.25rem
$ids-progress-tracker-progress-background-image-default-default
 none
$ids-progress-tracker-progress-background-image-current-default
 linear-gradient(to right, rgb(0, 84, 240) 50%, rgb(110, 98, 94) 50%)
$ids-progress-tracker-progress-background-image-current-vertical
 linear-gradient(to bottom, rgb(0, 84, 240) 50%, rgb(110, 98, 94) 50%)
$ids-progress-tracker-progress-background-image-complete-default
 none
$ids-progress-tracker-background-color-modal
 rgb(241, 236, 232)
$ids-progress-tracker-background-color-modal-drawer
 rgb(241, 236, 232)
$ids-progress-tracker-padding-top-modal
 1.5rem
$ids-progress-tracker-padding-top-modal-drawer
 1.5rem
$ids-progress-tracker-padding-bottom-modal
 1rem
$ids-progress-tracker-padding-bottom-modal-drawer
 1rem
$ids-progress-tracker-padding-bottom-media-query-sm-small
 1.5rem
$ids-progress-tracker-counter-font-size
 1.125rem
$ids-progress-tracker-counter-line-height
 1.75rem
$ids-progress-tracker-counter-color
 rgb(110, 98, 94)
$ids-progress-tracker-title-color-default
 rgb(110, 98, 94)
$ids-progress-tracker-title-color-current
 rgb(51, 30, 17)
$ids-progress-tracker-title-color-complete
 rgb(110, 98, 94)
$ids-progress-tracker-indicator-size
 1.5rem
$ids-progress-tracker-indicator-background-color-default
 transparent
$ids-progress-tracker-indicator-background-color-current
 transparent
$ids-progress-tracker-indicator-background-color-complete
 rgb(0, 84, 240)
$ids-progress-tracker-indicator-box-shadow-default
 inset 0 0 0 0.25rem rgb(110, 98, 94)
$ids-progress-tracker-indicator-box-shadow-current
 inset 0 0 0 0.25rem rgb(0, 84, 240)
$ids-progress-tracker-indicator-box-shadow-complete
 none
$ids-progress-tracker-indicator-background-image-default
 none
$ids-progress-tracker-indicator-background-image-current
 none
$ids-progress-tracker-indicator-background-image-complete
 url("data:image/svg+xml,%3Csvg xmlns=%27http://www.w3.org/2000/svg%27 viewBox=%270 0 32 32%27%3E%3Ctitle%3Echeck%3C/title%3E%3Cg class=%27nc-icon-wrapper%27 stroke-linecap=%27square%27 stroke-linejoin=%27miter%27 stroke-width=%273.5%27 fill=%27%23faf9f7%27 stroke=%27%23faf9f7%27%3E%3Cpolyline points=%272 16 11 25 30 6%27 fill=%27none%27 stroke=%27%23faf9f7%27 stroke-miterlimit=%2710%27/%3E%3C/g%3E%3C/svg%3E")
$ids-progress-tracker-indicator-background-size-default
 auto auto
$ids-progress-tracker-indicator-background-size-current
 auto auto
$ids-progress-tracker-indicator-background-size-complete
 0.75rem 0.75rem
$ids-progress-tracker-item-spacing-inset-media-query-base-default
 2.5rem 0 1rem 0
$ids-progress-tracker-item-spacing-inset-media-query-sm-default
 2.5rem 1.5rem 1rem 0
$ids-progress-tracker-item-spacing-inset-media-query-sm-small
 2.5rem 0 1rem 0
$ids-progress-tracker-item-spacing-inset-media-query-sm-vertical
 0 1.5rem 2rem 3rem
$ids-progress-tracker-gutter
 1rem
$ids-progress-tracker-item-min-width
 2rem
$ids-progress-tracker-spacing-inset-media-query-base-default
 0 0 1.5rem 0
$ids-progress-tracker-spacing-inset-media-query-sm-default
 0
Edit this section, Opens in new window

Changelog

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

14.29.2 (2022-10-11)

Bug Fixes

  • progress-tracker: fixed progress tracker background color (3fda696) , closes #646893

14.22.2 (2022-05-03)

Miscellaneous chores

  • package locks: update package locks (813eac7)
  • update deps: package locks updates (38e7a90)

14.20.1 (2022-04-19)

Miscellaneous chores

  • changelog: regenerate all CHANGELOG.md files (64ab385) , closes #586342
  • changelog: regenerate all changelogs after updating changelog generation (70789c9) , closes #587270

14.18.3 (2022-04-13)

Bug Fixes

  • changelog: generate new CHANGELOG.md files for root and packages (349fda4) , closes #586063 . We regenerate the files to include all relevant commits and to use conventional-commits at 100%

14.16.0 (2022-04-07)

Bug Fixes

  • 🐛 Add missing imports for global CSS Variables (fbf6f06) , closes #582437

14.13.0 (2022-04-06)

Features

  • 🎸 Add CSS Variables to Progress Tracker (81efcec) , closes #578308

Bug Fixes

  • 🐛 Encode data-value in design token documentation (85737c6)

Code Refactoring

Miscellaneous chores

14.9.0 (2022-03-03)

Miscellaneous chores

14.8.1 (2022-02-23)

Bug Fixes

  • 🐛 Add missing imports of typography CSS variables (e716c65) , closes #559412

reinstall (d425056)

bootstrap (9a713df)

merge (2b1c5f1)

reinstall (5221600)

reinstall (147df55)

  • use correct versions (f1b5deb)

  • Add engines for all packages (e95dfff)

reinstall (afce1f2)

reinstall (67f3140)

  • Add changelog.md to files (3338314)

Reinstall (a2abf51)

14.2.2 (2021-12-10)

Code Refactoring

reinstall (885c74b)

  • fix changelogs manually (b1232b4)

reinstall (545a069)

reinstall (e149c2c)

13.12.3 (2021-11-09)

⚠ BREAKING CHANGES

  • 🧨 The scope for If Design System npm packages has now changed from @if-design-system to @ids-core. We have also renamed the repository from if-design-system to ids-core
  • 🧨 Util is now renamed to Utils
  • 🧨 We have now changed the navigation structure for the documentation site. Please update any saved links!
  • 🧨 Navigation structure has now changed. Please see release notes!

Documentation Updates

  • ✏️ Make variations tables more condensed (4344a3a)

  • ✏️ Move position of the quick links (5cb0897)

  • ✏️ Remove unneeded margins for shortcuts (36c7e8d)

  • ✏️ Separate out CSS documentation (70f310e) , closes #467386

  • ✏️ Update links and change navigation structure (0bfd27d) , closes #490579

Code Refactoring

  • 💡 Categorize components (9965266) , closes #490579

  • 💡 Reduce spacing tokens, use correct size tokens (97aa461)

  • 💡 Rename scope and repository (3ea5423)

  • 💡 Use new navigation structure for documentation (415aee5) , closes #490579

  • another change in the structure (38a0d2e)

Miscellaneous chores

bootstrap (6fc1ed8)

  • fix all old references to util (d57bf17)

  • prepare for merge (0184490)

reinstall (da80dba)

  • Rename scope and repo (257684e)

  • use correct version for utils (49e72d9)

13.11.0 (2021-10-19)

Features

  • 🎸 Input field hot reload (eac76b7)

13.9.2 (2021-09-30)

Bug Fixes

  • 🐛 Complete the pseudo-element fix (1dcee2c)

13.7.0 (2021-09-22)

Documentation Updates

  • ✏️ Update linking layout and naming (15c383b)

13.6.3 (2021-09-17)

Bug Fixes

13.6.0 (2021-09-08)

Documentation Updates

  • Use default shortcut listing for demo links (a746602)

  • 🤖 Use node v14 (4009973)

bootstrap (d23e139)

  • 🤖 Use correct order for diff (cc6a4fd)

12.14.1 (2021-08-12)

Miscellaneous chores

  • 🤖 Add ci task to package.json without tests (21222e0) , closes #457627

12.13.1 (2021-08-11)

Bug Fixes

  • 🐛 Whitelist docs dir for npm packaging (1a5cfd0) , closes #457621

12.12.1 (2021-08-10)

Bug Fixes

  • 🐛 Make sure components using fonts, have fonts bundled (d5bb642) , closes #354912

  • 🤖 Remove .gitignore, use npm package.json files instead, ignore zip files for npm pack (49f0269) , closes #412081 . This will whitelist files to be used in "npm pack"

  • 🤖 Reinstall (e660696)

  • 🤖 Update published date (61e7ccf)

12.6.0 (2021-05-27)

Bug Fixes

  • 🐛 Manually set firstPublished and lastModified (e83af7d)

  • 🐛 We don't need lastModified (e458a12)

12.3.0 (2021-05-19)

Documentation Updates

  • ✏️ Documentation fixes (ad1882a)

12.0.0 (2021-05-05)

⚠ BREAKING CHANGES

  • 🧨 All of the mixins have now been renamed
  • 🧨 Teasers are no more. It has been replaces with Lifestyle Navigational Card, Text Navigational Card. Studio Teasers is gone, use Studio Navigational Card instead, which is based on the old Studio Crosslinks
  • 🧨 This extracts the Hero variation with no image into a separate, design updated component named Header
  • 🧨 Footer is now renamed to Global Footer

Features

  • 🎸 Rename and extract and update hero with no image to (384eb77) , closes #336508 . Header component

Bug Fixes

Code Refactoring

Miscellaneous chores

  • 🤖 Convert typography tokens from theo to SD (e48f255)

  • 🤖 Convert util tokens from theo to style-dictionary (99fb4f5)

  • 🤖 Finalize breakpoint token conversion (f50ea0d)

  • 🤖 Make sure all components are named with capital first (08e9a26)

  • 🤖 PR fixes (87bdedd)

  • 🤖 Reinstall (2c763ea)

  • 🤖 Reinstall (69e1a5b)

  • 🤖 Update all design token references (c640d15)

  • 🤖 Update references to util variables (b79ec36)

  • 🤖 Updating links (70f166e)

rebuild (7edb430)

  • 🤖 Rename Change Log to Changelog (d412e63)

  • 🤖 Remove all references to sketch (35fc554) , closes #339203

  • 🤖 Update package fields (200c0af)

  • reinstall packages (fcfacf4)

7.1.0 (2020-11-16)

Features

  • 🎸 Add support for auto generation of components index (9444600) , closes #309650

6.43.3 (2020-11-03)

Miscellaneous chores

  • 🤖 Manually set version (e4d9ca6)

  • 🤖 Rename repository from guybrush to if-design-system (c18bccd)

reinstall (2cefe15)

6.36.0 (2020-10-12)

Miscellaneous chores

  • 🤖 Add what-input to demo and dev files (56801b7)

6.34.0 (2020-09-29)

Features

  • 🎸 Add new component progress-tracker (d6d47c7)
Edit this section, Opens in new window
Contact us, Opens in new window