tkirby / activity-bar

iOS 7 style progress bar for showing ogoing activity

ActivityBar

[](https://travis-ci.org/Tanner Nelson/ActivityBar)

An iMessage UIProgressBar-style view for showing ogoing activity.

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Installation

ActivityBar is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "ActivityBar"

Getting Started

Add the ActivityBar to your view controller.

import UIKit
import ActivityBar

class ViewController: UIViewController {
    var activityBar: ActivityBar!

    override func viewDidLoad() {
        super.viewDidLoad()

        self.activityBar = ActivityBar.addTo(self)
    }
}

If there is a NavigationBar present, ActivityBar, will attach itself to the NavigationBar. Otherwise, it will be placed directly underneath the Status Bar.

Color

Change the color of the ActivityBar at any time. By default, ActivityBar will be the tintColor of your application.

self.activityBar.color = UIColor.greenColor()

Animation

Start and stop the ActivityBar's indefinite animation.

self.activityBar.start()
self.activityBar.stop()

Progress

Set the ActivityBar to display progress between 0% and 100%.

//displays the ActivityBar and animates to 75%
self.activityBar.progress = 0.75

The ActivityBar will animate between different states of progress. To hide the ActivityBar, set the progress property to nil.

//hides the ActivityBar
self.activityBar.progress = nil

Note: You can call start() at any point without first setting progress to nil.

Author

Tanner Nelson, [email protected]

License

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