BMYCircularProgressPullToRefresh 1.1.1

BMYCircularProgressPullToRefresh 1.1.1

TestsTested
LangLanguage Obj-CObjective C
License BSD 3.0
ReleasedLast Release Dec 2014

Maintained by Alberto De Bortoli.



  • By
  • Alberto De Bortoli and Stefan Dougan-Hyde

Pull to fresh with circular progress view as used in the Beamly iOS app.

1

This version of the pull to refresh feature can be used both on UITableViews and UICollectionViews and it has been inspired by Sam Vermette's SVPullToRefresh.

When dealing with a custom pull to refresh view, often the native UIRefreshControl is not ideal as it is not customizable. A common customization besides the pull to refresh, is to have a circular progress view with the logo of the app to show during the dragging. This version of the pull to refresh allows to preserve the contentInset on the scrollview.

Try out the included demo project.

Simple usage:

  • copy all the classes in the BMYCircularProgressPullToRefresh folder into your project
  • import BMYCircularProgressPullToRefresh.h in your (view controller) class
  • add the pull to refresh feature as so (you probably want to do to in the viewDidLoad method):
UIImage *logoImage = [UIImage imageNamed:@"bicon.png"];
UIImage *backCircleImage = [UIImage imageNamed:@"light_circle.png"];
UIImage *frontCircleImage = [UIImage imageNamed:@"dark_circle.png"];

BMYCircularProgressView *progressView = [[BMYCircularProgressView alloc] initWithFrame:CGRectMake(0, 0, 25, 25)
                                                                                  logo:logoImage
                                                                       backCircleImage:backCircleImage
                                                                      frontCircleImage:frontCircleImage];

[self.scrollView setPullToRefreshWithHeight:60.0f actionHandler:^(BMYPullToRefreshView *pullToRefreshView){
    // reload logic, call the following line when work is done 
    [pullToRefreshView stopAnimating];
}];

[self.scrollView.pullToRefreshView setPreserveContentInset:YES];
[self.scrollView.pullToRefreshView setProgressView:progressView];
- (void)dealloc {
    [self.scrollView tearDownPullToRefresh];
}

Licensing

This project is licensed under the BSD 3-Clause license

Contributions

Note that we are not accepting pull requests at this time.