https://github.com/mu29/pagingtableview

The simplest way to make your table view paginable
https://github.com/mu29/pagingtableview

infinite-scroll ios pagination swift swift3 tableview

Last synced: 8 months ago
JSON representation

The simplest way to make your table view paginable

• Host: GitHub
• URL: https://github.com/mu29/pagingtableview
• Owner: mu29
• License: mit
• Created: 2017-04-16T05:29:45.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2020-05-13T22:57:30.000Z (almost 6 years ago)
• Last Synced: 2024-03-15T00:01:23.201Z (almost 2 years ago)
• Topics: infinite-scroll, ios, pagination, swift, swift3, tableview
• Language: Swift
• Homepage:
• Size: 2.06 MB
• Stars: 55
• Watchers: 7
• Forks: 13
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# PagingTableView

[![Version](https://img.shields.io/cocoapods/v/PagingTableView.svg?style=flat)](http://cocoapods.org/pods/PagingTableView)

[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/mu29/PagingTableView/blob/master/LICENSE)

[![Platform](https://img.shields.io/cocoapods/p/PagingTableView.svg?style=flat)](http://cocoapods.org/pods/PagingTableView)

[![Swift 3.1](https://img.shields.io/badge/Swift-3.1-orange.svg?style=flat)](https://developer.apple.com/swift/)

The simplest way to add paginate (a.k.a infinite scroll) function to your table view.  

All you have to do is just set your table view class in the storyboard to `PagingTableView`, and implement the `PagingTableViewDelegate#paginate`

## Installation

`PagingTableView` is available through [CocoaPods](http://cocoapods.org). To install

it, simply add the following line to your Podfile:

```ruby

pod "PagingTableView"

```

## Example



See full example [here](https://github.com/mu29/PagingTableView/blob/master/Example).  

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

## Usage

First set your table view class in the storyboard to `PagingTableView`



Then implement `paginate` function. If `isLoading` is set to true, an indicator is displayed at the bottom of the table view. Otherwise, the indicator disappears and `UITableView.reloadData` is called.

```swift

class MainViewController: UIViewController {

  override func viewDidLoad() {

    ...

    contentTable.pagingDelegate = self

  }

  ...

}

extension MainViewController: PagingTableViewDelegate {

  func paginate(_ tableView: PagingTableView, to page: Int) {

    contentTable.isLoading = true

    contentDataSource.loadData(at: page) { contents in

      self.contents.append(contentsOf: contents)

      self.contentTable.isLoading = false

    }

  }

}

```

See [example](https://github.com/mu29/PagingTableView/blob/master/Example) for more information.

## APIs

| Name | Type | Description |

|---|---|---|

| `pagingDelegate` | `PagingTableViewDelegate` | Delegate pagination processing |

| `currentPage` | `Int` | Returns the current page |

| `isLoading` | `Bool` | Shows and hides the loading indicator. Reload table view data after loading |

| `reset()` | `Void` | Return page to 0 and call `paginate` function |

## Author

InJung Chung / [@mu29](http://mu29.github.io/)

## License

`PagingTableView` is available under the MIT license. See the [LICENSE](https://github.com/mu29/PagingTableView/blob/master/LICENSE) file for more info.