https://github.com/mac-gallagher/MultiProgressView
📊 An animatable view that depicts multiple progresses over time. Modeled after UIProgressView
https://github.com/mac-gallagher/MultiProgressView
carthage cocoapods ios progress progress-bar progress-view progressbar progressview swift ui-components
Last synced: 6 months ago
JSON representation
📊 An animatable view that depicts multiple progresses over time. Modeled after UIProgressView
- Host: GitHub
- URL: https://github.com/mac-gallagher/MultiProgressView
- Owner: mac-gallagher
- License: mit
- Created: 2018-06-26T00:36:00.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-03-27T14:41:12.000Z (over 4 years ago)
- Last Synced: 2025-05-12T04:47:51.805Z (6 months ago)
- Topics: carthage, cocoapods, ios, progress, progress-bar, progress-view, progressbar, progressview, swift, ui-components
- Language: Swift
- Homepage:
- Size: 1.98 MB
- Stars: 1,010
- Watchers: 14
- Forks: 63
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome - MultiProgressView - 📊 An animatable view that depicts multiple progresses over time. Modeled after UIProgressView. (OOM-Leaks-Crash / WebView-ProgressBar)
README
)
📊 **MultiProgressView** is an animatable view that depicts multiple progresses over time. Modeled after [UIProgressView](https://developer.apple.com/documentation/uikit/uiprogressview).
---
## Examples
To run the example project, clone the repo and run the `MultiProgressViewExample` target.
## Basic Usage
### Programmatic
1. Add a `MultiProgressView` to your view hierarchy:
```swift
let progressView = MultiProgressView()
view.addSubview(progressView)
```
2. Conform your class to the `MultiProgressViewDataSource` protocol and set your progress view's `dataSource`:
```swift
func numberOfSections(in progressView: MultiProgressView) -> Int
func progressView(_ progressView: MultiProgressView, viewForSection section: Int) -> ProgressViewSection
```
```swift
progressView.dataSource = self
```
3. Call `setProgress(section:to:)` to update your view's progress:
```swift
progressView.setProgress(section: 0, to: 0.4) //animatable
```
### Storyboards
1. Drag a `UIView` onto your view controller and set the view's class to `MultiProgressView` in the *Identity Inspector*:
3. Connect your progress view to your view controller with an `IBOutlet`:
4. Conform your view controller to the `MultiProgressViewDataSource` protocol and implement the required methods:
```swift
func numberOfSections(in progressView: MultiProgressView) -> Int
func progressView(_ progressView: MultiProgressView, viewForSection section: Int) -> ProgressViewSection
```
5. Set your view controller as the progress view's `dataSource`:
6. Call `setProgress(section:to:)` to update your view's progress:
```swift
progressView.setProgress(section: 0, to: 0.4) //animatable
```
## Customization
### MultiProgressView
Each `MultiProgressView` exposes the variables listed below. If using storyboards, many of these properties can be customized directly in the view's *Attribute Inspector*.
```swift
var cornerRadius: CGFloat = 0
var borderWidth: CGFloat = 0
var borderColor: UIColor? = .black
var lineCap: LineCapType = .square
var trackInset: CGFloat = 0
var trackBackgroundColor: UIColor? = .clear
var trackBorderColor: UIColor? = .black
var trackBorderWidth: CGFloat = 0
var trackImageView: UIImageView
var trackTitleLabel: UILabel
var trackTitleEdgeInsets: UIEdgeInsets = .zero
var trackTitleAlignment: AlignmentType = .center
```
**Note**: To apply a corner radius (using `layer.cornerRadius` or the `cornerRadius` variable) the `lineCap` type must be set to `.round`.
### ProgressViewSection
Each `ProgressViewSection` exposes the following variables:
```swift
var imageView: UIImageView
var titleLabel: UILabel
var titleEdgeInsets: UIEdgeInsets = .zero
var titleAlignment: AlignmentType = .center
```
## Installation
### CocoaPods
MultiProgressView is available through [CocoaPods](). To install it, simply add the following line to your Podfile:
pod 'MultiProgressView'
### Carthage
MultiProgressView is available through [Carthage](). To install it, simply add the following line to your Cartfile:
github "mac-gallagher/MultiProgressView"
### Swift Package Manager
MultiProgressView is available through [Swift PM](). To install it, simply add the package as a dependency in `Package.swift`:
```swift
dependencies: [
.package(url: "https://github.com/mac-gallagher/MultiProgressView.git", from: "1.2.0"),
]
```
### Manual
Download and drop the `MultiProgressView` directory into your project.
## Requirements
* iOS 9.0+
* Xcode 10.2+
* Swift 5.0+
## Apps Using MultiProgressView
We love to hear about apps that use MultiProgressView - feel free to submit a pull request and share yours here!
---
Made with ❤️ by Mac Gallagher
(Header design by Mazen Ghani)