HGCircularSlider Documentation

To install HGCircularSlider using CocoaPods, add the following line to your Podfile:

pod 'HGCircularSlider', '~> 2.2.1'

To install HGCircularSlider using Carthage, add the following line to your Cartfile:

github "HamzaGhazouani/HGCircularSlider"

Use MidPointCircularSlider to set a value relative to a midpoint within a range.

let circularSlider = MidPointCircularSlider(frame: myFrame)
circularSlider.minimumValue = 0.0
circularSlider.maximumValue = 10.0
circularSlider.distance = 1.0
circularSlider.midPointValue = 5.0

Use RangeCircularSlider to define a range between two points. You can customize the thumb images and set the number of rotations (rounds) for the full range.

let circularSlider = RangeCircularSlider(frame: myFrame)
circularSlider.startThumbImage = UIImage(named: "Bedtime")
circularSlider.endThumbImage = UIImage(named: "Wake")

let dayInSeconds = 24 * 60 * 60
circularSlider.maximumValue = CGFloat(dayInSeconds)

circularSlider.startPointValue = 1 * 60 * 60
circularSlider.endPointValue = 8 * 60 * 60
circularSlider.numberOfRounds = 2 // Two rotations for full 24h range

To use a CircularSlider as a non-interactive progress view, disable user interaction and set the thumb width and radius to zero.

let progressView = CircularSlider(frame: myFrame)
progressView.minimumValue = 0.0
progressView.maximumValue = 1.0
progressView.endPointValue = 0.2 // the progress 
progressView.userInteractionEnabled = false 
// to remove padding, for more details see issue #25
progressView.thumbLineWidth = 0.0
progressView.thumbRadius = 0.0

Use CircularSlider to create a simple slider with a minimum value, maximum value, and a single end point value.

let circularSlider = CircularSlider(frame: myFrame)
circularSlider.minimumValue = 0.0
circularSlider.maximumValue = 1.0
circularSlider.endPointValue = 0.2