CollectionView

main

Star

SwiftUI wrapper of UICollectionView.

ios swift swiftui uicollectionview uikit uiviewrepresentable

CollectionView

CollectionView is a SwiftUI wrapper of UICollectionView.

Have you ever wanted to make an app solely in SwiftUI, but the processing tradeoff of using Grid, Lazy_Stack, and Lazy_Grid are too significant? Wish you could stick with SwiftUI but still get the processing power of UICollectionView? Then try out CollectionView!

It’s a SwiftUI wrapper for UICollectionView that exposes all UICollectionViewDelegate/UICollectionViewDataSourcePrefetching delegate functions (via view modifiers). Plus, on iOS 16+, you can utilize 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. 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

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<Section, Item>.CellProvider closure to allow for more complicated configurations.
Finish documenting view modifiers.
Work on more concrete example for README/DocC articles.

Description

Swift Tools 5.9.0

Description

{
  "name": "CollectionView",
  "path": "/usr/src/package",
  "targets": [
    {
      "name": "CollectionViewTests",
      "path": "Tests/CollectionViewTests",
      "type": "test",
      "c99name": "CollectionViewTests",
      "sources": [
        "CollectionViewTests.swift"
      ],
      "module_type": "SwiftTarget",
      "target_dependencies": [
        "CollectionView"
      ]
    },
    {
      "name": "CollectionView",
      "path": "Sources/CollectionView",
      "type": "library",
      "c99name": "CollectionView",
      "sources": [
        "CollectionView+Coordinator.swift",
        "CollectionView+Initializers.swift",
        "CollectionView+ViewModifiers.swift",
        "CollectionView.swift",
        "Extensions/ListLayoutAppearance+DefaultBackgroundColor.swift",
        "Extensions/OrderedDictionary+IndexPath.swift",
        "ResultBuilders/Builder Inits.swift",
        "ResultBuilders/BuilderTesting.swift",
        "Testing/HostingInitTest.swift",
        "Testing/Initializer Testing.swift",
        "Testing/ListInitTest.swift",
        "Testing/StandardInitMultipleSelectTest.swift"
      ],
      "module_type": "SwiftTarget",
      "product_memberships": [
        "CollectionView"
      ],
      "product_dependencies": [
        "OrderedCollections",
        "CompositionalLayoutBuilder"
      ]
    }
  ],
  "products": [
    {
      "name": "CollectionView",
      "type": {
        "library": [
          "automatic"
        ]
      },
      "targets": [
        "CollectionView"
      ]
    }
  ],
  "platforms": [
    {
      "name": "ios",
      "version": "14.0"
    },
    {
      "name": "maccatalyst",
      "version": "14.0"
    },
    {
      "name": "tvos",
      "version": "14.0"
    },
    {
      "name": "visionos",
      "version": "1.0"
    }
  ],
  "dependencies": [
    {
      "url": "https://github.com/apple/swift-collections.git",
      "type": "sourceControl",
      "identity": "swift-collections",
      "requirement": {
        "range": [
          {
            "lower_bound": "1.0.0",
            "upper_bound": "2.0.0"
          }
        ]
      }
    },
    {
      "url": "https://github.com/edonv/CompositionalLayoutBuilder.git",
      "type": "sourceControl",
      "identity": "compositionallayoutbuilder",
      "requirement": {
        "range": [
          {
            "lower_bound": "0.1.0",
            "upper_bound": "1.0.0"
          }
        ]
      }
    }
  ],
  "tools_version": "5.9",
  "manifest_display_name": "CollectionView"
}

View More Packages from this Author

Package Dump

{
  "name": "CollectionView",
  "targets": [
    {
      "name": "CollectionView",
      "type": "regular",
      "exclude": [],
      "settings": [],
      "resources": [
        {
          "path": "../PrivacyInfo.xcprivacy",
          "rule": {
            "copy": {}
          }
        }
      ],
      "dependencies": [
        {
          "product": [
            "OrderedCollections",
            "swift-collections",
            null,
            null
          ]
        },
        {
          "product": [
            "CompositionalLayoutBuilder",
            "CompositionalLayoutBuilder",
            null,
            null
          ]
        }
      ],
      "packageAccess": true
    },
    {
      "name": "CollectionViewTests",
      "type": "test",
      "exclude": [],
      "settings": [],
      "resources": [],
      "dependencies": [
        {
          "byName": [
            "CollectionView",
            null
          ]
        }
      ],
      "packageAccess": true
    }
  ],
  "products": [
    {
      "name": "CollectionView",
      "type": {
        "library": [
          "automatic"
        ]
      },
      "targets": [
        "CollectionView"
      ]
    }
  ],
  "pkgConfig": null,
  "platforms": [
    {
      "options": [],
      "version": "14.0",
      "platformName": "ios"
    },
    {
      "options": [],
      "version": "14.0",
      "platformName": "maccatalyst"
    },
    {
      "options": [],
      "version": "14.0",
      "platformName": "tvos"
    },
    {
      "options": [],
      "version": "1.0",
      "platformName": "visionos"
    }
  ],
  "providers": null,
  "packageKind": {
    "root": [
      "/usr/src/package"
    ]
  },
  "dependencies": [
    {
      "sourceControl": [
        {
          "identity": "swift-collections",
          "location": {
            "remote": [
              {
                "urlString": "https://github.com/apple/swift-collections.git"
              }
            ]
          },
          "requirement": {
            "range": [
              {
                "lowerBound": "1.0.0",
                "upperBound": "2.0.0"
              }
            ]
          },
          "productFilter": null
        }
      ]
    },
    {
      "sourceControl": [
        {
          "identity": "compositionallayoutbuilder",
          "location": {
            "remote": [
              {
                "urlString": "https://github.com/edonv/CompositionalLayoutBuilder.git"
              }
            ]
          },
          "requirement": {
            "range": [
              {
                "lowerBound": "0.1.0",
                "upperBound": "1.0.0"
              }
            ]
          },
          "productFilter": null
        }
      ]
    }
  ],
  "toolsVersion": {
    "_version": "5.9.0"
  },
  "cLanguageStandard": null,
  "cxxLanguageStandard": null,
  "swiftLanguageVersions": null
}

Dependencies

swift-collections1.1.1
CompositionalLayoutBuilder0.1.4

Dependencies

{
  "url": "/usr/src/package",
  "name": "CollectionView",
  "path": "/usr/src/package",
  "version": "unspecified",
  "identity": "package",
  "dependencies": [
    {
      "url": "https://github.com/apple/swift-collections.git",
      "name": "swift-collections",
      "path": "/usr/src/package/.build/checkouts/swift-collections",
      "version": "1.1.1",
      "identity": "swift-collections",
      "dependencies": []
    },
    {
      "url": "https://github.com/edonv/CompositionalLayoutBuilder.git",
      "name": "CompositionalLayoutBuilder",
      "path": "/usr/src/package/.build/checkouts/CompositionalLayoutBuilder",
      "version": "0.1.4",
      "identity": "compositionallayoutbuilder",
      "dependencies": []
    }
  ]
}

Last updated: Fri Oct 18 2024 01:20:12 GMT-0900 (Hawaii-Aleutian Daylight Time)