1
0
mirror of https://github.com/tabler/tabler.git synced 2025-12-22 01:44:25 +04:00
Files
tabler/docs/ui/components/steps.mdx
2025-01-10 22:31:24 +01:00

155 lines
4.5 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: Steps
summary: Steps are used to guide users through complex processes, making them easier and more intuitive. Breaking a multi-step process into smaller parts and tracking progress along the way helps users complete it successfully.
new: true
description: Simplify complex processes with steps.
---
## Default markup
Steps provide a clear visual representation of a users progress through a multi-step process. By showing what has been completed and what remains, steps enhance usability and encourage task completion.
To create a default progress tracker, use the `.steps` class and define each step as a `.step-item`. The active step clearly indicates the current position in the process.
```html
<div class="steps">
<a href="#" class="step-item">
Step 1
</a>
<a href="#" class="step-item">
Step 2
</a>
<a href="#" class="step-item active">
Step 3
</a>
</div>
```
The example below demonstrates a simple progress tracker with four steps, where the third step is active.
```html example centered
<div class="steps">
<a href="#" class="step-item">
Step 1
</a>
<a href="#" class="step-item">
Step 2
</a>
<a href="#" class="step-item active">
Step 3
</a>
<span href="#" class="step-item">
Step 4
</span>
</div>
```
## Tooltips
Add tooltips, if you want to provide users with additional information about the steps they are expected to complete. Tooltips are displayed when a user hovers over a given step and help clarify what might not be clear from the interface.
To add a tooltip, use the `data-bs-toggle="tooltip"` attribute and specify the tooltip content with the `title` attribute.
```html
<a href="#" class="step-item" data-bs-toggle="tooltip" data-bs-placement="top" title="Step 1 description">
Step 1
</a>
```
The example below demonstrates a progress tracker with tooltips for each step.
```html example centered height="20rem"
<div class="steps">
<a href="#" class="step-item" data-bs-toggle="tooltip" data-bs-placement="top" title="Step 1 description">
Step 1
</a>
<a href="#" class="step-item" data-bs-toggle="tooltip" data-bs-placement="top" title="Step 2 description">
Step 2
</a>
<a href="#" class="step-item active" data-bs-toggle="tooltip" data-bs-placement="top" title="Step 3 description">
Step 3
</a>
<span href="#" class="step-item" data-bs-toggle="tooltip" data-bs-placement="top" title="Step 4 description">
Step 4
</span>
</div>
```
## Color
You can customize the default progress indicator by changing the color to one that better suits your design. Click [here](/docs/ui/base/colors) to see the range of available colors.
```html
<div class="steps steps-green">
...
</div>
```
The example below demonstrates a progress tracker with two different color schemes.
```html example centered
<div class="steps steps-green">
<a href="#" class="step-item">
Step 1
</a>
<a href="#" class="step-item">
Step 2
</a>
<a href="#" class="step-item active">
Step 3
</a>
<span href="#" class="step-item">
Step 4
</span>
</div>
<div class="steps steps-red">
<a href="#" class="step-item">
Step 1
</a>
<a href="#" class="step-item">
Step 2
</a>
<a href="#" class="step-item active">
Step 3
</a>
<span href="#" class="step-item">
Step 4
</span>
</div>
```
## Steps without title
For designs with limited space, use progress indicators without titles and add tooltips to provide the necessary details.
```html example centered
<div class="steps">
<a href="#" class="step-item" data-bs-toggle="tooltip" data-bs-placement="top" title="Step 1 description"></a>
<a href="#" class="step-item" data-bs-toggle="tooltip" data-bs-placement="top" title="Step 2 description"></a>
<a href="#" class="step-item active" data-bs-toggle="tooltip" data-bs-placement="top" title="Step 3 description"></a>
<span href="#" class="step-item" data-bs-toggle="tooltip" data-bs-placement="top" title="Step 4 description"></span>
</div>
```
## Steps with numbers
Use the `steps-counter` class to create a progress tracker with numbers instead of titles and change the color to customize it.
```html
<div class="steps steps-counter">
...
</div>
```
The example below demonstrates a progress tracker with numbers and a different color scheme.
```html example centered
<div class="steps steps-counter">
<a href="#" class="step-item"></a>
<a href="#" class="step-item active"></a>
<span href="#" class="step-item"></span>
<span href="#" class="step-item"></span>
<span href="#" class="step-item"></span>
</div>
```