HKRefreshControl is a refresh control that mimics iOS6's UIRefreshControl behavior but is also available for iOS5. It uses HKCircularProgressView to show the animated "pull progress" and "activity indicator" views but you can also implement views of your own.
- Use CocoaPods by adding pod 'HKRefreshControl' in your Podfile.
- Manually:
- Clone this repository
- Copy HKRefreshControl and UITableViewController+HKRefreshControl files (.h and .m) into your project and do not forget HKCircularProgressView.
A refresh control is usually used with a UITableView. This is why we included an extension to the UITableViewController class, to mimic UIRefreshControl's usage.
In order to associate your UITableView with a HKRefreshControl:
- In your UITableViewController, set the customRefreshControl property (using a simple [[HKRefreshControl alloc] init]).
- Add a target and action for the UIControlEventValueChanged control event.
- When UIControlEventValueChanged is triggered (when the control is pulled), start refreshing your data.
- When your data is done refreshing, call endRefreshing on the HKRefreshControl, it will stop the animations and hide the control.
Like UIRefreshControl, you can customize HKRefreshControl:
- tintColor: sets the tint color of the indicator views and the label (available through the UIAppearance API).
- attributedTitle: use this property to set a label at the bottom of the control.