Latest 1.0.0
Homepage https://github.com/thePsguy/ButtonProgressBar-iOS
License MIT
Platforms ios 8.0
Authors

CI Status
Version
License
Platform

GIF Preview

Example

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

GIF Preview

Requirements

iOS > 7.0

Installation

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

pod "ButtonProgressBar-iOS"

Usage

import ButtonProgressBar_iOS

Initialize just like you would any other UIButton:

var progressButton = ButtonProgressBar(frame: CGRect)
view.addSubview(progressButton)

Since this is a UIButton subclass, targets and labels can be set in the same way:

progressButton.addTarget(nil, action: #selector(self.tapped), for: .touchUpInside)
progressButton.setTitle("Download", for: .normal)

The completion image can be set with;

This image must be set since no default exists.

  setCompletionImage(image: UIImage)

Indeterminate loading can be handled with the following functions:

startIndeterminate(withTimePeriod time: TimeInterval)
startIndeterminate(withTimePeriod time: TimeInterval, andTimePadding padding: TimeInterval)

/*
Time Padding is the duration (default 0.5), in seconds, before starting the next cycle.
Time Period is the total time (animation + padding) that 1 cycle of the loading takes.
*/

stopIndeterminate()  //Stops the indeterminate loading.

For determinate usage or otherwise, progress can be set with:

setProgress(progress: CGFloat, _ animated: Bool) 
/*
Progress ranges from 0.0 to 1.0

If animated is true, linearly animates to progress.
*/

resetProgress()  //Set progress to 0.0 unanimated.

Set the progress and background colors:

setBackgroundColor(color: UIColor)
setProgressColor(color: UIColor)

To explicitly show/hide the title / image:

hideTitle(_ hidden: Bool)
hideImage(_ hidden: Bool)

Stop indeterminate loading if active, set progress to 1.0 animated, and display completion image if set.

 Needs to be called explicitly when loading determinate as well.
  triggerCompletion()

Author

Pushkar Sharma, [email protected]


Inspiration from Dribbble

Android version available!

License

ButtonProgressBar-iOS is available under the MIT license. See the LICENSE file for more info.

Latest podspec

{
    "name": "ButtonProgressBar-iOS",
    "version": "1.0.0",
    "summary": "A simple progress bar UIButton subclass.",
    "description": "Custom UIButton class with loading animation for determinate and indeterminate processes like network download / upload.nSet progress animated, or unanimated. Uses CABasicAnimation and layer stroke to display progress.nText enlarge on tap. Animated completion image.",
    "homepage": "https://github.com/thePsguy/ButtonProgressBar-iOS",
    "screenshots": [
        "https://raw.githubusercontent.com/thePsguy/ButtonProgressBar-iOS/master/output_F2Ryon.gif",
        "https://raw.githubusercontent.com/thePsguy/ButtonProgressBar-iOS/master/preview.gif"
    ],
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Pushkar Sharma": "[email protected]"
    },
    "source": {
        "git": "https://github.com/thePsguy/ButtonProgressBar-iOS.git",
        "tag": "1.0.0"
    },
    "social_media_url": "https://twitter.com/thePsguy",
    "platforms": {
        "ios": "8.0"
    },
    "source_files": "Source/*.swift",
    "pushed_with_swift_version": "3.0"
}

Pin It on Pinterest

Share This