Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/KyoheiG3/PagingView
Infinite paging, Smart auto layout, Interface of similar to UIKit.
https://github.com/KyoheiG3/PagingView
Last synced: about 1 month ago
JSON representation
Infinite paging, Smart auto layout, Interface of similar to UIKit.
- Host: GitHub
- URL: https://github.com/KyoheiG3/PagingView
- Owner: KyoheiG3
- License: mit
- Created: 2015-09-03T06:32:45.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-10-24T01:25:01.000Z (almost 6 years ago)
- Last Synced: 2024-04-24T18:57:52.424Z (5 months ago)
- Language: Swift
- Homepage:
- Size: 895 KB
- Stars: 315
- Watchers: 15
- Forks: 41
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - PagingView - Infinite paging, Smart auto layout, Interface of similar to UIKit. (UI / Table View / Collection View)
- awesome-ios-star - PagingView - Infinite paging, Smart auto layout, Interface of similar to UIKit. (UI / Table View / Collection View)
README
[](https://github.com/Carthage/Carthage)
[](http://cocoadocs.org/docsets/PagingView)
[](http://cocoadocs.org/docsets/PagingView)
[](http://cocoadocs.org/docsets/PagingView)
Infinite paging, Smart auto layout, Interface of similar to UIKit.
#### [Appetize's Demo](https://appetize.io/app/030jqrt4nkm60rc0qu1wrvg4v8)
## Requirements
- Swift 4.2
- iOS 8.0 or later
## How to Install PagingView
#### Cocoapods
Add the following to your `Podfile`:
```Ruby
pod "PagingView"
```
#### Carthage
Add the following to your `Cartfile`:
```Ruby
github "KyoheiG3/PagingView"
```
## Usage
### PagingView Variable
```swift
weak var dataSource: PagingViewDataSource?
```
* DataSource of `PagingView`. Same as `dataSource` of `UICollectionView`.
```swift
var pagingMargin: UInt
```
* Margin between the content.
* Default is `0`.
```swift
var pagingInset: UInt
```
* Inset of content relative to size of `PagingView`.
* Value of two times than of `pagingInset` to set for the left and right of `contentInset`.
* Default is `0`.
```swift
var infinite: Bool
```
* Infinite looping enabled flag.
* Default is `true`.
### PagingView Function
```swift
func dequeueReusableCellWithReuseIdentifier(identifier: String) -> PagingView.PagingViewCell
```
* Used by the `delegate` to acquire an already allocated cell, in lieu of allocating a new one.
```swift
func registerNib(nib: UINib?, forCellWithReuseIdentifier identifier: String)
```
* If a nib is registered, it must contain exactly 1 top level object which is a `PagingViewCell`.
```swift
func registerClass(viewClass: T.Type, forCellWithReuseIdentifier identifier: String)
```
* If a class is registered, it will be instantiated via `init(frame: CGRect)`.
```swift
func reloadData()
```
* Requery the `dataSource` and `delegate` as necessary.
```swift
func invalidateLayout()
```
* Relayout as necessary.
```swift
func numberOfSections() -> Int
func numberOfItemsInSection(section: Int) -> Int
```
* Information about the current state of the `PagingView`.
```swift
func scrollToPosition(position: PagingView.PagingView.Position, indexPath: IndexPath? = default, animated: Bool = default)
```
* To scroll at `Position`.
* Cell configure is performed at `IndexPath`.
```swift
func configureAtPosition(position: PagingView.PagingView.Position, toIndexPath: IndexPath? = default)
```
* Configure cell of `Position`.
* IndexPath of cell in the center if indexPath is `nil`.
### PagingViewDataSource Function
```swift
func pagingView(pagingView: PagingView.PagingView, numberOfItemsInSection section: Int) -> Int
```
* Paging count number of paging item in section.
```swift
func pagingView(pagingView: PagingView.PagingView, cellForItemAtIndexPath indexPath: IndexPath) -> PagingView.PagingViewCell
```
* Implementers should *always* try to reuse cells by setting each cell's reuseIdentifier and querying for available reusable cells with `dequeueReusableCellWithReuseIdentifier:`.
```swift
optional func numberOfSectionsInPagingView(pagingView: PagingView.PagingView) -> Int
```
* Paging count number of paging item section in `PagingView`.
* Default return value is `1`.
```swift
optional func indexPathOfStartingInPagingView(pagingView: PagingView.PagingView) -> IndexPath?
```
* IndexPath when `pagingView:cellForItemAtIndexPath:` is first called
* Default return value is `0 - 0` of `IndexPath` instance.
### PagingViewDelegate Function
```swift
optional func pagingView(pagingView: PagingView.PagingView, willDisplayCell cell: PagingView.PagingViewCell, forItemAtIndexPath indexPath: IndexPath)
optional func pagingView(pagingView: PagingView.PagingView, didEndDisplayingCell cell: PagingView.PagingViewCell, forItemAtIndexPath indexPath: IndexPath)
```
* Called at the display and end-display of.
### PagingViewCell Function
```swift
func prepareForReuse()
```
* if the cell is reusable (has a reuse identifier), this is called just before the cell is returned from the paging view method `dequeueReusableCellWithReuseIdentifier:`.
## LICENSE
Under the MIT license. See LICENSE file for details.