Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hamzaghazouani/hgcircularslider
A custom reusable circular / progress slider control for iOS application.
https://github.com/hamzaghazouani/hgcircularslider
circle circular clock ios progress progress-bar progress-circle slider slider-range swift timer
Last synced: 1 day ago
JSON representation
A custom reusable circular / progress slider control for iOS application.
- Host: GitHub
- URL: https://github.com/hamzaghazouani/hgcircularslider
- Owner: HamzaGhazouani
- License: mit
- Created: 2016-11-07T23:58:30.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-08-13T07:12:04.000Z (6 months ago)
- Last Synced: 2024-10-29T17:57:17.991Z (4 months ago)
- Topics: circle, circular, clock, ios, progress, progress-bar, progress-circle, slider, slider-range, swift, timer
- Language: Swift
- Homepage:
- Size: 16.5 MB
- Stars: 2,594
- Watchers: 35
- Forks: 277
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# HGCircularSlider
[](#backers) [](#sponsors) [](https://twitter.com/GhazouaniHamza)
[](https://travis-ci.org/HamzaGhazouani/HGCircularSlider)
[](http://cocoapods.org/pods/HGCircularSlider)
[](http://cocoapods.org/pods/HGCircularSlider)
[]()
[](http://cocoapods.org/pods/HGCircularSlider)
[](https://github.com/Carthage/Carthage)
[](https://codebeat.co/projects/github-com-hamzaghazouani-hgcircularslider)
[](http://cocoadocs.org/docsets/HGCircularSlider/)
[](http://clayallsopp.github.io/readme-score?url=https://github.com/hamzaghazouani/hgcircularslider/tree/develop)
## Example
    
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## You also may like
* **[HGPlaceholders](https://github.com/HamzaGhazouani/HGPlaceholders)** - Nice library to show placeholders for any UITableView in your project
* **[HGRippleRadarView](https://github.com/HamzaGhazouani/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](https://swift.org/package-manager/)
Follow this [doc](https://developer.apple.com/documentation/xcode/adding_package_dependencies_to_your_app?language=swift).
HGCircularSlider is also available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
``` ruby
pod 'HGCircularSlider', '~> 2.2.1'
```
HGCircularSlider is also available through [Carthage](https://github.com/Carthage/Carthage). To install
it, simply add the following line to your Cartfile:
``` ruby
github "HamzaGhazouani/HGCircularSlider"
```
## Usage
1. Change the class of a view from UIView to CircularSlider, RangeCircularSlider or MidPointCircularSlider
2. Programmatically:
```swift
let circularSlider = CircularSlider(frame: myFrame)
circularSlider.minimumValue = 0.0
circularSlider.maximumValue = 1.0
circularSlider.endPointValue = 0.2
```
OR
```swift
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
```swift
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](http://cocoadocs.org/docsets/HGCircularSlider/).
You can also install documentation locally using [jazzy](https://github.com/realm/jazzy).
## References
The UI examples of the demo project inspired from [Dribbble](https://dribbble.com).
[Player](https://dribbble.com/shots/3062636-Countdown-Timer-Daily-UI-014)
[BasicExample](https://dribbble.com/shots/2153963-Dompet-Wallet-App)
[OClock](https://dribbble.com/shots/2671286-Clock-Alarm-app)
The project is Inspired by [UICircularSlider](https://github.com/Zedenem/UICircularSlider)
## Author
Hamza Ghazouani, [email protected]
## License
HGCircularSlider is available under the MIT license. See the LICENSE file for more info.