updated

Author: flocked

README.md

@@ -8,7 +8,9 @@ A framework for `UICollectionView` and `UITableView` that provides:
 
 ## UICollectionViewDiffableDataSource & TableViewDiffableDataSource
 
-It provides handlers for selecting, reordering, focusing and editing cells and additional functionality.
+### Handlers
+
+There are handlers for selecting, reordering, focusing and editing cells.
 
 Examples of some of the included handlers:
 
@@ -24,7 +26,7 @@ diffableDataSource.displayingHandlers.willDisplay = { itemIdentifier, cell in
 }
 ```
 
-`TableViewDiffableDataSource` provides handlers for reordering of cells/items like `UICollectionViewDiffableDataSource’s` reordering handlers:
+`TableViewDiffableDataSource` provides handlers for reordering of cells/items like the reordering handlers of `UICollectionViewDiffableDataSource` that Apple provides:
 
 ```swift
 // Allow every item to be reordered
@@ -40,6 +42,21 @@ tableViewDataSource.reorderingHandlers.didReorder = { [weak self] transaction, _
 }
 ```
 
+### Empty datasource view
+
+`emptyCollectionView` and `emptyTableView` displays the provided view when the datasource doesn't contain any items:
+
+```swift
+diffableDataSource.emptyTableView = myEmptyView
+```
+
+Alternatively you can use `emptyContentConfiguration` and provide an `UIContentConfiguration`:
+
+```swift
+let loadingConfiguration = UIContentUnavailableConfiguration.loading()
+diffableDataSource.emptyContentConfiguration = loadingConfiguration
+```
+
 ## UITableView Cell Registration
 
 A registration for the table view’s cells similar to `UICollectionView.CellRegistration`.

Sources/AdvancedCollectionTableView-iOS/TableView/DataSource/ContentConfigurationView.swift

@@ -0,0 +1,35 @@
+//
+//  ContentConfigurationView.swift
+//
+//
+//  Created by Florian Zand on 21.02.24.
+//
+
+import UIKit
+
+class ContentConfigurationView: UIView {
+    var contentView: (UIView & UIContentView)
+
+    var contentConfiguration: UIContentConfiguration {
+        didSet {
+            updateContentView()
+        }
+    }
+    
+    func updateContentView() {
+        contentView.removeFromSuperview()
+        contentView = contentConfiguration.makeContentView()
+        addSubview(withConstraint: contentView)
+    }
+    
+    init(configuration: UIContentConfiguration) {
+        self.contentConfiguration = configuration
+        self.contentView = configuration.makeContentView()
+        super.init(frame: .zero)
+        addSubview(withConstraint: contentView)
+    }
+    
+    required init?(coder: NSCoder) {
+        fatalError("init(coder:) has not been implemented")
+    }
+}

Sources/AdvancedCollectionTableView-iOS/TableView/DataSource/TableViewDiffableDataSource.swift

@@ -36,14 +36,46 @@ class TableViewDiffableDataSource<SectionIdentifierType, ItemIdentifierType> : U
         }
     }
 
-    /// The view that is displayed when the datasource doesn't contain any items.
-    open var emptyCollectionView: UIView? = nil {
+    /**
+     The view that is displayed when the datasource doesn't contain any items.
+     
+     When using a empty table view, ``emptyContentConfiguration`` is set to `nil`.
+     */
+    open var emptyTableView: UIView? = nil {
         didSet {
-            guard oldValue != emptyCollectionView else { return }
+            guard oldValue != emptyTableView else { return }
+            if emptyTableView != nil {
+                emptyContentConfiguration = nil
+            }
             updateEmptyCollectionView()
         }
     }
 
+    /**
+     The content configuration that content view is displayed when the datasource doesn't contain any items.
+     
+     When using a content configuration, ``emptyTableView`` is set to `nil`.
+     */
+    open var emptyContentConfiguration: UIContentConfiguration? = nil {
+        didSet {
+            if let configuration = emptyContentConfiguration {
+                emptyTableView?.removeFromSuperview()
+                emptyTableView = nil
+                if let emptyContentView = self.emptyContentView {
+                    emptyContentView.contentConfiguration = configuration
+                } else {
+                    emptyContentView = .init(configuration: configuration)
+                }
+            } else {
+                emptyContentView?.removeFromSuperview()
+                emptyContentView = nil
+            }
+            updateEmptyCollectionView()
+        }
+    }
+    
+    var emptyContentView: ContentConfigurationView?
+    
     override func apply(_ snapshot: NSDiffableDataSourceSnapshot<SectionIdentifierType, ItemIdentifierType>, animatingDifferences: Bool = true, completion: (() -> Void)? = nil) {
         super.apply(snapshot, animatingDifferences: animatingDifferences, completion: completion)
         updateEmptyCollectionView()
@@ -58,9 +90,12 @@ class TableViewDiffableDataSource<SectionIdentifierType, ItemIdentifierType> : U
     func updateEmptyCollectionView() {
         let snapshot = snapshot()
         if !snapshot.itemIdentifiers.isEmpty && !snapshot.sectionIdentifiers.isEmpty {
-            emptyCollectionView?.removeFromSuperview()
-        } else if let emptyCollectionView = self.emptyCollectionView {
-            tableView?.addSubview(withConstraint: emptyCollectionView)
+            emptyTableView?.removeFromSuperview()
+            emptyContentView?.removeFromSuperview()
+        } else if let emptyTableView = self.emptyTableView, emptyTableView.superview != tableView {
+            tableView?.addSubview(withConstraint: emptyTableView)
+        } else if let emptyContentView = self.emptyContentView, emptyContentView.superview != tableView {
+            tableView?.addSubview(withConstraint: emptyContentView)
         }
     }