thuatcao/jksteppedprogressbar

Stepped ProgressBar for iOS

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. To install it, simply add the following line to your Podfile:

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

TODO

• Add image for steps
• Respect language direction for drawing

Author

• Johnykutty, [email protected]
• Jayahari V, [email protected]
• And others

License

JKSteppedProgressBar is available under the MIT license. See the LICENSE file for more info.