Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bastidest/vue-step-progress
A simple Vue component that displays a Progress Bar with labels for each step
https://github.com/bastidest/vue-step-progress
component progress progress-bar progressbar steps vue
Last synced: about 2 months ago
JSON representation
A simple Vue component that displays a Progress Bar with labels for each step
- Host: GitHub
- URL: https://github.com/bastidest/vue-step-progress
- Owner: bastidest
- License: mit
- Created: 2018-03-01T23:09:54.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-03-15T03:05:49.000Z (almost 2 years ago)
- Last Synced: 2024-12-19T14:07:21.182Z (2 months ago)
- Topics: component, progress, progress-bar, progressbar, steps, vue
- Language: Vue
- Homepage:
- Size: 2.12 MB
- Stars: 53
- Watchers: 2
- Forks: 18
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.MD
- License: LICENSE
Awesome Lists containing this project
README
 [](https://app.fossa.com/projects/git%2Bgithub.com%2Fbastidest%2Fvue-step-progress?ref=badge_shield)
# Vue Step Progress Bar
## Demo
## Installation
Install the plugin with npm:
```shell
# Vue 3.x
npm install --save vue-step-progress
# Vue 2.x
npm install --save vue-step-progress@0
```
## Usage
⚠️ The default settings use Font Awesome for the checkmark icon. You can change the css icon class by using the
'icon-class' prop.
Add the Library import in the components you want to use the progress bar in:
```javascript
import StepProgress from 'vue-step-progress';
// import the css (OPTIONAL - you can provide your own design)
import 'vue-step-progress/dist/main.css';
// ...
// register the component in your Vue instance
components: {
'step-progress': StepProgress
},
// ...
```
Put the `step-progress` element into your HTML where you want the Component to appear and pass the `steps` Array Prop
and the `current-step` Number prop.
```html
```
## Props
#### `steps`
A string array of all steps to be displayed. The Strings will be present as labels in the component. Example:
```javascript
['Step 1', 'Step 2', 'Step 3']
```
#### `current-step`
A simple Number prop that defines the index of the active step. Example:
```
2
```
#### `icon-class`
_Optional_
The css class of the checkmark icon. Default:
```
fa fa-check
```
#### `active-color`
_Optional_
A String prop that defines the active step color. It is red by default. Example:
```
blue
```
#### `passive-color`
_Optional_
A String prop that defines the passive step color. It is gray by default. Example:
```
black
```
#### `active-thickness`
_Optional_
A Number prop that defines the active step thickness. It is 5 by default. Example:
```
10
```
#### `passive-thickness`
_Optional_
A Number prop that defines the passive step thickness. It is 5 by default. Example:
```
10
```
#### `line-thickness`
_Optional_
A Number prop that defines the line thickness. It is 12 by default. Example:
```
10
```
## Development
It is recommended to develop and build inside a docker container. `start.sh` is a convenience script to help you with that.
To start a development server, execute:
```bash
./start.sh dev-container
```
This will setup a new docker container, install npm dependencies and start the development server under http://localhost:3000
Document all user-visible changes in the "Unreleased" section in `CHANGELOG.MD`.
## Publishing (maintainer only)
Create a the `.npmrc` file:
```
//registry.npmjs.org/:_authToken=
```
Update package.json version, create tag, create changelog, push, npm publish:
```bash
./start.sh publish
```