Custom page size paging for UICollectionView — supports page dimensions smaller than the collection view itself.

中文版

• Screen Record
• Description
• Requirements
• Installation
• Usage
• API

• When your desired page size is smaller than the collection view's frame, UICollectionView.isPagingEnabled won't work correctly. ZLCollectionFreePageLayout solves this with a custom snap-to-page scroll behavior.
• You do not need to set collectionView.isPagingEnabled = true. Paging is handled automatically by the layout.
• Supports both .horizontal and .vertical scroll directions.

pod 'ZLCollectionFreePageLayout'
# or pin a version:
pod 'ZLCollectionFreePageLayout', '~> 0.0.7'

Download or clone the repo, then drag ZLCollectionFreePageLayout/ZLCollectionFreePageLayout.swift into your project.

1. Import the module:

import ZLCollectionFreePageLayout

2. Create and configure a ZLCollectionFreePageLayout instance, then assign it to your collection view:

private lazy var collectionView: UICollectionView = {
    let layout = ZLCollectionFreePageLayout()

    // Custom page width (horizontal) or page height (vertical)
    layout.pageWOrH = 200.0
    layout.scrollDirection = .horizontal        // or .vertical
    layout.minimumLineSpacing = 10.0
    layout.minimumInteritemSpacing = 10.0
    layout.sectionInset = UIEdgeInsets(top: 10, left: 10, bottom: 10, right: 10)

    let cv = UICollectionView(frame: .zero, collectionViewLayout: layout)
    cv.showsHorizontalScrollIndicator = false
    return cv
}()

3. That's it — no need to set isPagingEnabled.