Skip to content

jkmathew/JKSteppedProgressBar

Repository files navigation

JKSteppedProgressBar

CI Status Version Platform License

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

Demo Video

TODO

  • Add image for steps
  • Respect language direction for drawing

Author

License

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