Popularity
2.8
Declining
Activity
0.0
Stable
116
9
16

Code Quality Rank: L5
Programming language: Swift
License: MIT License
Tags: UI     Button    
Latest version: v1.1.1

ProgressButton alternatives and similar libraries

Based on the "Button" category.
Alternatively, view ProgressButton alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of ProgressButton or a related project?

Add another 'Button' Library

README

ProgressButton Carthage compatible GitHub release

[Gif video](./progress_button.gif)

Check it out

To run the example project, clone the repo, and open the 'Example/Example.xcodeproj' file.

Requirements

This component is written using Swift and Dynamic Frameworks, so iOS 8.x is required. However you may want to manually import the source files into your project, if you need to support 7.x.

Installation

ProgressButton is available through Carthage. To install it, simply add the following line to your Cartfile:

github "sprint84/ProgressButton" ~> 1.1.1

Installing Carthage

To install the carthage tool on your system, please download and run the Carthage.pkg file for the latest release, then follow the on-screen instructions.

Alternately, you can use Homebrew and install the carthage tool on your system simply by running brew update and brew install carthage.

For further details, please visit the Carthage Github page

Usage

ProgressButton is intended to be used in conjunction with UIToolbar or UITabBar. By default, when instantiated this component will try to center itself within its parent view. Although possible, setting the frame of this button manually is not recommended. Using the button in a UIToolbar is quite simple. First you need to import the module:

import ProgressButton

Then instantiate the view and add it to a UIToolbar or UITabBar.

let addButton = ProgressButton()
addButton.addInView(toolbar)

You can normally add actions to ProgressButton using addTarget:action:forControlEvents since it is a subclass of UIButton. However, we added a simpler closure method if you want to keep code inline.

addButton.setAction {
    print("Action performed")
}

ProgressButton displays a progress bar around it's frame. Setting the current progress works as expected:

addButton.setProgress(self.progress, animated: true)

Customization

ProgressButton supports some layout customizations, and we are working to improve customizable parameters in the future. For example, ProgressButton supports 3 color levels, that can be triggered by a threshold value.

public var normalProgressColor: UIColor
public var advisoryProgressColor: UIColor
public var warningProgressColor: UIColor 

Users can define when those colors will be triggered, in a range 0..1. If you set values above 1.0 for these threshold values, the progress bar will always display the normalProgressColor:

public var advisoryProgressThreshold: Double
public var warningProgressThreshold: Double

You can also change the position where the progress arc starts. The default value for the initial angle is 90° or π/2. That means the arc will begin drawing from the bottom of the circunference.

And you can change an offset angle that will be calculated from the initial angle in both directions (clockwise and counter-clockwise), creating an empty section on the initial angle position. These values must be set in Radians.

/// Starting point, in radian angles, where the progress arc will begin. Default: π/2
public var initialAngle: Double

/// Arc offset, in radian angles, from `initialAngle` where the progress arc will start drawing. Default: π/6
public var arcOffset: Double

[Angle description](./angle_description.png?raw=true)

Author

Reefactor, Inc., [email protected]

License

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


*Note that all licence references and agreements mentioned in the ProgressButton README section above are relevant to that project's source code only.