Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ziryanov/CCInfiniteScrolling


https://github.com/ziryanov/CCInfiniteScrolling

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README

        

# CCInfiniteScrolling

These UIScrollView categories makes it super easy to add infinite scrolling functionalities to any UIScrollView (or any of its' subclass). Instead of relying on delegates and/or subclassing `UIViewController`, CCInfiniteScrolling uses the Objective-C runtime to add the following 2 methods to `UIScrollView`:

```objective-c
- (void)addTopInfiniteScrollingWithActionHandler:(void (^)())actonHandler;
- (void)addBottomInfiniteScrollingWithActionHandler:(void (^)())actonHandler;
```

![](https://github.com/ziryanov/CCInfiniteScrolling/raw/master/1.gif)
![](https://github.com/ziryanov/CCInfiniteScrolling/raw/master/2.gif)
## Installation

[CocoaPods](http://cocoapods.org) is the recommended way to add `CCInfiniteScrolling` to your project.

Here's an example **podfile** that installs `CCInfiniteScrolling`.

###Podfile

```ruby
platform :ios, '6.0'

pod 'CCInfiniteScrolling'
```

## Usage

(see sample Xcode project in `/Example`)

### Adding Infinite Scrolling

```objective-c
[_tableView addBottomInfiniteScrollingWithActionHandler:^{
//this block will be triggered when user has scrolled to bottom of tableview;
//you can start "load more" request
//simply call [_tableView reloadData] when your request finishes
}];
```

You can temporarily disable the infinite scrolling view by setting the `infiniteScrollingDisabled` property:

```objective-c
tableView.infiniteScrollingDisabled = YES;
```

#### Customization

The infinite scrolling view can be customized using the following methods:

```objective-c
@property (nonatomic) IBOutlet UIView *infiniteScrollingCustomView;
@property (nonatomic) IBOutlet UIView *infiniteScrollingCustomFailedView;
+ (void)setInfinityScrollingCustomBlockFailedImage:(UIImage *)image;

@property (nonatomic) IBOutlet UIView *topInfiniteScrollingCustomView;
@property (nonatomic) IBOutlet UIView *bottomInfiniteScrollingCustomView;
@property (nonatomic) IBOutlet UIView *topInfiniteScrollingCustomFailedView;
@property (nonatomic) IBOutlet UIView *bottomInfiniteScrollingCustomFailedView;
@property (nonatomic) BOOL topInfiniteScrollingDisabled;
@property (nonatomic) BOOL bottomInfiniteScrollingDisabled;
@property (nonatomic) BOOL topInfiniteScrollingBlockFailed;
@property (nonatomic) BOOL bottomInfiniteScrollingBlockFailed;
```