HGCircularSlider
A custom reusable circular / progress slider control for iOS application.
Install / Use
/learn @HamzaGhazouani/HGCircularSliderREADME
HGCircularSlider
Example

To run the example project, clone the repo, and run pod install from the Example directory first.
You also may like
- HGPlaceholders - Nice library to show placeholders for any UITableView in your project
- HGRippleRadarView - A beautiful radar view to show nearby users with ripple animation, fully customizable
Requirements
- iOS 9.0+
- Xcode 11.4
Installation
HGCircularSlider is also available through Swift Package Manager
Follow this doc.
HGCircularSlider is also available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'HGCircularSlider', '~> 2.2.1'
HGCircularSlider is also available through Carthage. To install it, simply add the following line to your Cartfile:
github "HamzaGhazouani/HGCircularSlider"
Usage
- Change the class of a view from UIView to CircularSlider, RangeCircularSlider or MidPointCircularSlider
- Programmatically:
let circularSlider = CircularSlider(frame: myFrame)
circularSlider.minimumValue = 0.0
circularSlider.maximumValue = 1.0
circularSlider.endPointValue = 0.2
OR
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
OR
let circularSlider = MidPointCircularSlider(frame: myFrame)
circularSlider.minimumValue = 0.0
circularSlider.maximumValue = 10.0
circularSlider.distance = 1.0
circularSlider.midPointValue = 5.0
If you would like to use it like a progress view
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
Documentation
Full documentation is available on CocoaDocs.<br/> You can also install documentation locally using jazzy.
References
The UI examples of the demo project inspired from Dribbble.
Player <br/> BasicExample<br/> OClock<br/>
The project is Inspired by UICircularSlider
Author
Hamza Ghazouani, hamza.ghazouani@gmail.com
License
HGCircularSlider is available under the MIT license. See the LICENSE file for more info.
Related Skills
node-connect
340.5kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
84.2kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
340.5kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
commit-push-pr
84.2kCommit, push, and open a PR
