FFCircularProgressView
  • September 23, 2023

FFCircularProgressView – An iOS 7-inspired blue circular progress view

ss1 ss2 ss3 ss4

This progress view is inspired by the new progress view in the App Store, iOS 7. Also the colors are taken from there.

See it in action


Requirements


FFCircularProgressView works on iOS version > 5 and is compatible with both ARC and non-ARC projects. It depends on the following Apple frameworks, which should already be included with most Xcode templates:

  • Foundation.framework
  • UIKit.framework
  • CoreGraphics.framework
  • QuartzCore.framework

You will need LLVM 3.0 or later in order to build FFCircularProgressView.

Adding FFCircularProgressView to your project


There are plenty of ways to add this view to your project. Make sure you add the aforementioned frameworks to your project as well.

GIT submodule

You have the canonical git submodule option. Simply issue git submodule add https://github.com/elbryan/FFCircularProgressView.git <path> in your root folder of your repository.

CocoaPods

  1. Add a pod entry to your Podfile dependencies file such as pod 'FFCircularProgressView', '>= 0.1'.
  2. Install the pod(s) by running pod install.
  3. Import the progress view with `#import “FFCircularProgressView.h” wherever you need in your project.

Source files

Manually add the source files to your project. The files you need are ‘FFCircularProgressView.h’, ‘FFCircularProgressView.m’, ‘UIColor+iOS7.h’, ‘UIColor+iOS7.m’.

Usage


Just use it as it is a normal UIProgressView. Make sure you set the progress value in the main thread 😉

double delayInSeconds = 2.0;
dispatch_time_t popTime = dispatch_time(DISPATCH_TIME_NOW, (int64_t)(delayInSeconds * NSEC_PER_SEC));
dispatch_after(popTime, dispatch_get_main_queue(), ^(void){
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_BACKGROUND,0), ^{
for (float i=0; i<1.1; i+=0.01F) {
dispatch_async(dispatch_get_main_queue(), ^{
[circularProgressView setProgress:i];
});
usleep(10000);
}
});
});

You can also control the progress view spin animation by using the following two methods to start and stop the spinning, respectively:

// Start spinning
[circularProgressView startSpinProgressBackgroundLayer];

// Stop spinning
[circularProgressView stopSpinProgressBackgroundLayer];

Acknowledgments


The code to draw the tick has been adapted from GSProgressView.

GitHub


View Github

YOU MIGHT ALSO LIKE...
PermissionsSwiftUI: A SwiftUI package to handle permissions

PermissionsSwiftUI displays and handles permissions in SwiftUI. It is largely inspired by SPPermissions. The UI is highly customizable and resembles an Apple style. ...

Pager tab strip view

Introduction PagerTabStripView is the first pager view built in pure SwiftUI. It provides a component to create interactive pager views ...

PageView

SwiftUI view enabling page-based navigation, imitating the behaviour of UIPageViewController in iOS.

Pages

    

How to take action when a property changes

1. Taking Action When a Property Changes: Property Observers Swift lets you observe and respond to changes in a property’s ...