MKRingProgressView
Ring progress view similar to Activity app on Apple Watch
Features
- Progress animation
- Customizable start/end and backdrop ring colors
- Customizable ring width
- Customizable shadow under progress line end
- Progress values above 100% (or 360°) can also be displayed
Installation
CocoaPods
MKRingProgressView
is available through CocoaPods. To install
it, simply add the following line to your Podfile:
pod 'MKRingProgressView'
Manually
Just add MKRingProgressView
folder to your Xcode project.
Usage
See example Xcode project. It also contains additional classes for convenient grouping of 3 ring progress views replicating Activity app by Apple.
Interface Builder
MKRingProgressView
can be set up in Storyboard. Specify startColor
, endColor
, ringWidth
and optional backgroundRingColor
(if not set, defaults to startColor
with 15% opacity).
Code
let ringProgressView = MKRingProgressView(frame: CGRect(x: 0, y: 100, width: 100, height: 100))
ringProgressView.startColor = UIColor.redColor()
ringProgressView.endColor = UIColor.magentaColor()
ringProgressView.ringWidth = 25
ringProgressView.progress = 0.0
ringProgressView.allowsAntialiasing = true
view.addSubview(ringProgressView)
To adjust progress
animation duration, use CATransaction
:
CATransaction.begin()
CATransaction.setAnimationDuration(1.0)
ringProgressView.progress = 1.0
CATransaction.commit()
Dependencies
Conical gradient image for progress ring is drawn using MKGradientGenerator. It is already included in the code, so just add MKGradientGenerator.swift
along with MKRingProgressView.swift
file to your project.
Requirements
- iOS 7.0 (Cocoapods requires iOS 8 for Swift)
- Xcode 7, Swift 2.0
License
MKRingProgressView
is available under the MIT license. See the LICENSE file for more info.