Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/khawajafarooq/ProgressMeter

Measuring the progress with annotations 🔱
https://github.com/khawajafarooq/ProgressMeter

ios progressbar swift4 xcode

Last synced: about 1 month ago
JSON representation

Measuring the progress with annotations 🔱

Host: GitHub
URL: https://github.com/khawajafarooq/ProgressMeter
Owner: khawajafarooq
License: mit
Created: 2017-11-22T08:29:16.000Z (almost 7 years ago)
Default Branch: master
Last Pushed: 2017-12-12T12:11:58.000Z (almost 7 years ago)
Last Synced: 2024-08-02T15:02:23.249Z (about 2 months ago)
Topics: ios, progressbar, swift4, xcode
Language: Swift
Homepage:
Size: 583 KB
Stars: 107
Watchers: 6
Forks: 10
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-ios - ProgressMeter - Display the progress on a meter with customized annotations for iOS developed in Swift (UI / ProgressView)
awesome-ios-star - ProgressMeter - Display the progress on a meter with customized annotations for iOS developed in Swift (UI / ProgressView)

README

        


[![CI Status](https://travis-ci.org/khawajafarooq/ProgressMeter.svg?style=svg)](https://travis-ci.org/khawajafarooq/ProgressMeter)

[![Swift 4.0](https://img.shields.io/badge/swift-4.0-red.svg?style=flat)](https://developer.apple.com/swift)

[![Version](https://img.shields.io/cocoapods/v/ProgressMeter.svg?style=flat)](http://cocoapods.org/pods/ProgressMeter)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

[![License](https://img.shields.io/cocoapods/l/ProgressMeter.svg?style=flat)](http://cocoapods.org/pods/ProgressMeter)

[![Platform](https://img.shields.io/cocoapods/p/ProgressMeter.svg?style=flat)](http://cocoapods.org/pods/ProgressMeter)

## Description

Displaying the progress in a meter control. `ProgressMeter` lets you create your custom annotations that display either on top or bottom of meter. So, it's not just an ordinary progress bar, it gives the better visual. 💯

## Use Cases

### Fitness App 🏃‍

Building a pedometer has never been easier. If you are looking for something other than a gauge control, you have come to the right place. Have a look 🤓



### Banking App 🏦

Talking about financial apps. We all 've come across with such scenarios to show the rewards earned or a cash back. `ProgressMeter` is here to help with a unique user experience. 🏧



## Example

### Interface Builder

Guess what? You can do that all in design time without writing a single line of code.

Drag & drop a UIView from the object library and follow the steps:

**Step 1:**

Set the Class & Module **Identity Inspector > Custom Class**



**Step 2:**

Under **Attribute Inspector** you can change the properties and check everything on the fly 🚀

* maxValue: Maximum value of the meter

* progress: Current progress of meter

* numberOfDivisions: How many divisions you want to display

* Rest are pretty much self explanatory



### Code 👨‍💻

Hook your view (ProgressMeter) property on your view controller and try out the snippets inside **viewDidLoad**;

**Snippet # 1:** Looking for setting up the control with your own data 👨‍🏫

```swift

func setupWithCustomData() {

    progressControl.maxValue = 20000

    progressControl.data = [1999, 4999, 9999, 14999]

    progressControl.progress = 14999 / 20000

}

```

**Snippet # 2:** Don't have the data set? `ProgressMeter` can create its own data 🔢

```swift

func setupWithControlData() {

    progressControl.maxValue = 20000

    progressControl.numberOfDivisions = 4

    progressControl.progress = 0.4

}

```

**Snippet # 3:** Setup the visual aspect 💄

```swift

func visualSetup() {

    progressControl.progressTintColor = .purple

    progressControl.trackTintColor = .gray

    progressControl.borderWidth = 1

    progressControl.borderColor = .darkGray

    progressControl.annotationTextColor = .purple

    progressControl.dividerColor = .darkGray

}

```

## Installation

### CocoaPods

`ProgressMeter` is available through [CocoaPods](http://cocoapods.org). To install

it, simply add the following line to your Podfile:

```ruby

pod 'ProgressMeter'

```

### Carthage

To integrate `ProgressMeter` into your Xcode project using Carthage, specify the following in your `Cartfile`:

```ogdl

github "khawajafarooq/ProgressMeter"

```

Run `carthage update` to build the framework and drag the built `ProgressMeter.framework` into your Xcode project.

---

## Requirements

| Support | Version |

| --- | --- |

| iOS | 9.0 |

| Swift | 4.0 |

## Up Coming Features 🎏

- [x] Carthage support

- [x] Display Annotations either on top or bottom

## Issues 🚫

- [ ] Some tweakings required to use `ProgressMeter` inside a Stack View

## Author 🙏🏻

**Web**: [Khawaja Farooq](http://khawajafarooq.github.io)

**Twitter**: [@khfarooq](https://twitter.com/khfarooq)

**Medium**: [@khfarooq](https://medium.com/@khfarooq)

## License

`ProgressMeter` is available under the MIT license. See the LICENSE file for more info.