paging-collection-view-layout

KO | EN

gitlite — search

#javascript #python #typescript #llm #go #android #rust #linux #macos #cli #kubernetes #ios #openai #open-source

paging-collection-view-layout

(★ 183)

custom collection view layout that allows you to page by cell, not screen

File Explorer

Download Latest Version (.zip)

- - AppDelegate.swift
  - ViewController.swift
- - project.pbxproj
- example-multiple-items-per-page.gif
- example-skip.gif
- example-vertical.gif
- example.gif
- spacing-vertical.jpg
- spacing.png
.gitignore
LICENSE
PagingCollectionViewLayout.podspec
PagingCollectionViewLayout.swift
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# paging-collection-view-layout
custom collection view layout that allows you to page by cell, not screen

![](https://raw.githubusercontent.com/akxo/paging-collection-view-layout/master/Media/example.gif)
## installation
### cocoapods
use [cocoapods](http://cocoapods.org/) to install `PagingCollectionViewLayout` by adding it to your `Podfile`:

```ruby
platform :ios, '9.0'
use_frameworks!
pod 'PagingCollectionViewLayout'
```

``` swift
import PagingCollectionViewLayout
```
### manual
add `PagingCollectionViewLayout.swift` to your project
## usage

instantiate a layout property

```swift
let layout = PagingCollectionViewLayout()
```
set the following properties
```swift
layout.itemSize = 
layout.minimumLineSpacing = 
layout.scrollDirection = .horizontal
```
instantiate a collection view using the layout property
```swift
let collectionView = UICollectionView(frame: .zero, collectionViewLayout: layout)
```
for snappy scrolling set the following
```swift
collectionView.decelerationRate = .fast
```

#### note:
~~collectionView.isPagingEnabled = true~~
## optional customization
### vertical scrolling
![](https://raw.githubusercontent.com/akxo/paging-collection-view-layout/master/Media/example-vertical.gif)
```swift
layout.scrollDirection = .vertical
```
or since the default is vertical

~~layout.scrollDirection = .horizontal~~
### section spacing
- center the item in focus
- allow the previous item to be visible

![](https://raw.githubusercontent.com/akxo/paging-collection-view-layout/master/Media/spacing.png)
![](https://raw.githubusercontent.com/akxo/paging-collection-view-layout/master/Media/spacing-vertical.jpg)

set the following property
```swift
layout.sectionInset = 
```
- **horizontal collection view -** set left and right insets
- **vertical collection view -** set top and bottom insets

### skipping items

![](https://raw.githubusercontent.com/akxo/paging-collection-view-layout/master/Media/example-skip.gif)

`layout.velocityThresholdPerPage` determines the velocity needed to skip an item (default = 2.0)
- a non zero swipe velocity will result in the collection view scrolling to the prev/next item
- the number of items skipped = swipe velocity / velocityThresholdPerPage

### multiple items per page

![](https://raw.githubusercontent.com/akxo/paging-collection-view-layout/master/Media/example-multiple-items-per-page.gif)

```swift
layout.numberOfItemsPerPage = 2
```

paging-collection-view-layout

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

paging-collection-view-layout

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README