https://github.com/edonv/collectionview

SwiftUI wrapper of UICollectionView.
https://github.com/edonv/collectionview

ios swift swiftui uicollectionview uikit uiviewrepresentable

Last synced: 2 months ago
JSON representation

SwiftUI wrapper of UICollectionView.

• Host: GitHub
• URL: https://github.com/edonv/collectionview
• Owner: edonv
• License: mit
• Created: 2023-09-28T17:55:57.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-06-11T20:13:43.000Z (7 months ago)
• Last Synced: 2024-10-14T12:17:52.046Z (3 months ago)
• Topics: ios, swift, swiftui, uicollectionview, uikit, uiviewrepresentable
• Language: Swift
• Homepage:
• Size: 80.1 KB
• Stars: 22
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# CollectionView

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fedonv%2FCollectionView%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/edonv/CollectionView)

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fedonv%2FCollectionView%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/edonv/CollectionView)

`CollectionView` is a SwiftUI wrapper of [`UICollectionView`](https://developer.apple.com/documentation/uikit/uicollectionview).

Have you ever wanted to make an app solely in SwiftUI, but the processing tradeoff of using [`Grid`](https://developer.apple.com/documentation/swiftui/grid), [`Lazy_Stack`](https://developer.apple.com/documentation/swiftui/grouping-data-with-lazy-stack-views), and [`Lazy_Grid`](https://developer.apple.com/documentation/swiftui/layout-fundamentals#dynamically-arranging-views-in-two-dimensions) are too significant? Wish you could stick with SwiftUI but still get the processing power of [`UICollectionView`](https://developer.apple.com/documentation/uikit/uicollectionview)? Then try out CollectionView!

It’s a SwiftUI wrapper for `UICollectionView` that exposes all [`UICollectionViewDelegate`](https://developer.apple.com/documentation/uikit/uicollectionviewdelegate)/[`UICollectionViewDataSourcePrefetching`](https://developer.apple.com/documentation/uikit/uicollectionviewdatasourceprefetching) delegate functions (via view modifiers). Plus, on iOS 16+, you can utilize [`UIHostingConfiguration`](https://developer.apple.com/documentation/swiftui/uihostingconfiguration) to use SwiftUI views for the cells.

Plus, by passing your data source as a `Binding`, it updates changes to the view using [`UICollectionViewDiffableDataSource`](https://developer.apple.com/documentation/uikit/uicollectionviewdiffabledatasource). This also means it doesn't fully reload the view on every change, but rather, they're reloaded internally by the `UICollectionView`.

It’s still a work in progress (especially with testing everything + documentation), but please give it a try and send feedback my way!

## Usage

- Make sure to use `.ignoresSafeArea()` if it's meant to be full-screen.

## To-Do's

- [x] Implement `UICellConfigurationState`.

- [ ] Add support for `NSCollectionView`.

- [ ] Make sure `CollectionView` isn't updating itself more than necessary? or is it not because it's a `RepresentableView`?

- [ ] Condense initializers somehow...

- [ ] Add support for section snapshots.

    - [ ] Add support for expandable sections.

- [ ] Add support for section headers/footers.

- [ ] Refactor `cellRegistrationHandler` out of primary initializers and replace with a `UICollectionViewDiffableDataSource.CellProvider` closure to allow for more complicated configurations. 

- [ ] Finish documenting view modifiers.

- [ ] Work on more concrete example for README/DocC articles.