Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jkmathew/jksteppedprogressbar
Stepped ProgressBar for iOS
https://github.com/jkmathew/jksteppedprogressbar
ios-swift ios-thirdparty progress-bar swift-3 swift-4
Last synced: about 1 month ago
JSON representation
Stepped ProgressBar for iOS
- Host: GitHub
- URL: https://github.com/jkmathew/jksteppedprogressbar
- Owner: jkmathew
- License: mit
- Created: 2016-08-22T16:34:54.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2020-06-22T06:34:28.000Z (over 4 years ago)
- Last Synced: 2024-12-16T00:02:50.834Z (about 1 month ago)
- Topics: ios-swift, ios-thirdparty, progress-bar, swift-3, swift-4
- Language: Swift
- Size: 164 KB
- Stars: 132
- Watchers: 5
- Forks: 33
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# JKSteppedProgressBar
[](https://travis-ci.org/jkmathew/JKSteppedProgressBar)
[](http://cocoapods.org/pods/JKSteppedProgressBar)
[](http://cocoapods.org/pods/JKSteppedProgressBar)
[](http://cocoapods.org/pods/JKSteppedProgressBar)
## Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## Requirements
To use JKSteppedProgressBar Xcode 8.0 or later is required
## Installation
JKSteppedProgressBar is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'JKSteppedProgressBar'
```
JKSteppedProgressBar can be added and configured directly from storyboard.
## How to Add Stepped Progress Bar
- Add a blank UIView and set constraints
- Set the Class & Module from identity inspector
- Set the active & inactive color from Attributes inspector
### setting custom title
- Use the IBOutlet instance to set properties
- Set your title array to _titles_ property
```
progressbar.titles = ["Step 1", "Step 2", "Step 3"]
```
### setting custom title and images
- Use the IBOutlet instance to set properties
- Set your title array to _titles_ property
- Set your images array to _images_ property
```
progressbar.titles = ["Step 1", "Step 2", "Step 3"]
progressbar.images = [
UIImage(named: "DaisyDuck")!,
UIImage(named: "MickeyMouse")!,
UIImage(named: "MinnieMouse")!,
]
```
### setting custom color for the progress
- after setting your titles or images, set the property **activeStepColors**
```
progressbar.activeStepColors = [
UIColor.red,
UIColor.orange,
UIColor.green,
]
```
- this will change the color whenever you are at that step. For example, when you are at step 1, it will be red. And in second step, the whole progress bar will become orange and when you are at the last step, it will be green. So that the user will get a feeling of accomplishment through the steps.
-
### setting custom active-images
- this will make it possible to use this as progress for forms
- Set your images to *activeImages* property
- Set your tintActiveImage to tint the images to the active color (default: false)
- Set your justCheckCompleted to select everything behind the current step but keep the current step highlighted (default: true)
```
progressbar.activeImages = [
UIImage(named: "check")!,
UIImage(named: "check")!,
UIImage(named: "check")!,
]
progressbar.tintActiveImage = true
progressbar.justCheckCompleted = false
```
## Demo
[](http://www.youtube.com/watch?v=gKFrOL7nD6I)
## TODO
- [x] Add image for steps
- [x] Respect language direction for drawing
## Author
- Johnykutty, [email protected]
- Jayahari V, [email protected]
- And [others](https://github.com/jkmathew/JKSteppedProgressBar/graphs/contributors)
## License
JKSteppedProgressBar is available under the MIT license. See the LICENSE file for more info.