Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/iwasrobbed/RPCircularProgress
(Swift) Circular progress UIView subclass with UIProgressView properties
https://github.com/iwasrobbed/RPCircularProgress
bar chart circle ios pie progress ring swift
Last synced: 3 months ago
JSON representation
(Swift) Circular progress UIView subclass with UIProgressView properties
- Host: GitHub
- URL: https://github.com/iwasrobbed/RPCircularProgress
- Owner: iwasrobbed
- License: mit
- Archived: true
- Created: 2016-04-07T13:32:18.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2020-03-27T11:52:40.000Z (over 4 years ago)
- Last Synced: 2024-08-13T02:45:55.179Z (3 months ago)
- Topics: bar, chart, circle, ios, pie, progress, ring, swift
- Language: Swift
- Homepage:
- Size: 225 KB
- Stars: 257
- Watchers: 11
- Forks: 55
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - RPCircularProgress - (Swift) Circular progress UIView subclass with UIProgressView properties. (UI / Activity Indicator)
- awesome-ios-star - RPCircularProgress - (Swift) Circular progress UIView subclass with UIProgressView properties. (UI / Activity Indicator)
README
## RPCircularProgress
[![Coverage Status](https://coveralls.io/repos/github/iwasrobbed/RPCircularProgress/badge.svg?branch=master)](https://coveralls.io/github/iwasrobbed/RPCircularProgress?branch=master)
[![Build Status](https://travis-ci.org/iwasrobbed/RPCircularProgress.svg?branch=master)](https://travis-ci.org/iwasrobbed/RPCircularProgress)
[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/iwasrobbed/RPCircularProgress/blob/master/LICENSE)
[![CocoaPods](https://img.shields.io/cocoapods/v/RPCircularProgress.svg?maxAge=2592000)]()
[![Swift](https://img.shields.io/badge/language-Swift-blue.svg)](https://swift.org)⚠️ To use with Swift 2.3 please ensure you are using == 0.2.3 ⚠️
⚠️ To use with Swift 3.x please ensure you are using >= 0.3.0 ⚠️
⚠️ To use with Swift 4.x please ensure you are using >= 0.4.0 ⚠️
⚠️ To use with Swift 4.2 please ensure you are using >= 0.4.1 ⚠️
⚠️ To use with Swift 5.0 please ensure you are using >= 0.5.0 ⚠️
UIView subclass written in Swift to show circular progress.
![Example Usage](ohhai.gif)
Is your app using it? [Let me know!](mailto:[email protected])
Please see the included example app for sample usage.
### Styles
* Indeterminate (spins infinitely)
* Normal (set progress between 0.0 and 1.0)
* Mixed (can make it indeterminate, but also animate progress to 1.0)### Public API
```swift
/**
Enables or disables the indeterminate (spinning) animation- parameter enabled: Whether or not to enable the animation (defaults to `true`)
- parameter completion: An optional closure to execute after the animation completes
*/
open func enableIndeterminate(_ enabled: Bool = true, completion: CompletionBlock? = nil) {}
``````swift
/**
Updates the progress bar to the given value with the optional properties- parameter progress: The progress to update to, pinned between `0` and `1`
- parameter animated: Whether or not the update should be animated (defaults to `true`)
- parameter initialDelay: Sets an initial delay before the animation begins
- parameter duration: Sets the overal duration that the animation should complete within
- parameter completion: An optional closure to execute after the animation completes
*/
open func updateProgress(_ progress: CGFloat, animated: Bool = true, initialDelay: CFTimeInterval = 0, duration: CFTimeInterval? = nil, completion: CompletionBlock? = nil) {}
```### Properties
Note: Most properties below are `@IBInspectable`, but I don't use Interface Builder personally so let me know if you see any issues.
`var trackTintColor: UIColor`
* The color of the empty progress track (gets drawn over)`var progressTintColor: UIColor`
* The color of the progress bar`var innerTintColor: UIColor?`
* The color the notched out circle within the progress area (if there is one)`var roundedCorners: Bool`
* Sets whether or not the corners of the progress bar should be rounded`var thicknessRatio: CGFloat`
* Sets how thick the progress bar should be (pinned between `0.01` and `1`)`var clockwiseProgress: Bool`
* Sets whether or not the animation should be clockwise`var timingFunction: CAMediaTimingFunction`
* A timing function defining the pacing of the animation. Defaults to ease in, ease out.`var progress: CGFloat`
* Getter for the current progress (not observed from any active animations)`var indeterminateProgress: CGFloat`
* Sets how much of the progress bar should be filled during an indeterminate animation, pinned between `0.05` and `0.9`
* **Note:** This can be overriden / animated from by using updateProgress(...)`var indeterminateDuration: CFTimeInterval`
* Controls the speed at which the indeterminate progress bar animates### Supports
Swift, ARC & iOS 8+, Autolayout or springs and struts### A little help from my friends
Please feel free to fork and create a pull request for bug fixes or improvements, being sure to maintain the general coding style, adding tests, and adding comments as necessary.### Credit
This library is effectively a Swift port of [DACircularProgress](https://github.com/danielamitay/DACircularProgress) with some minor changes to the API, so it should be fairly easy to act as a replacement. I really loved that library but unfortunately it wasn't being maintained.