Added footer support #43 (#46)

First cut of footer support #43 

Footer use orthogonal to header use.

As before, header/footer inside scroll region for List-based variants. And outside scroll region for Stack- and Grid-based variants.

Configurability of header/footer in inside/outside scrolling region disabled for now, as it may have scalability issues. Will need to be investigated.

Author: reedes

README.md

@@ -17,7 +17,8 @@ macOS | iOS
 * Supporting both value and reference semantics (including Core Data, which uses the latter)
 * Option to support a bound data source, where inline controls can directly mutate your data model
 * Support for single-select, multi-select, or no selection
-* Option to sort by column, with indicators and concise syntax
+* Option to specify a header and/or footer
+* Option to sort by column in header/footer, with indicators and concise syntax
 * Option to specify a row background and/or overlay
 * On macOS, option for hover events, such as to highlight row under the mouse cursor
 * MINIMAL use of View erasure (i.e., use of `AnyView`), which can impact scalability and performance\*\*
@@ -150,6 +151,41 @@ Table View      | Type      | Select | Value | Reference | Bound | Filter
 
 \* filtering with bound values likely not scalable as implemented. If you can find a better way to implement, please submit a pull request!
 
+## Header/Footer
+
+Optionally attach a header (or footer) to your table:
+
+```swift
+var body: some View {
+    TablerList(header: header,
+               footer: footer,
+               row: row,
+               results: fruits)
+}
+
+private func header(ctx: Binding<Context>) -> some View {
+    LazyVGrid(columns: gridItems) {
+        Text("ID")
+        Text("Name")
+        Text("Weight")
+        Text("Color")
+    }
+}
+
+private func footer(ctx: Binding<Context>) -> some View {
+    LazyVGrid(columns: gridItems) {
+        Text("ID")
+        Text("Name")
+        Text("Weight")
+        Text("Color")
+    }
+}
+```
+
+Where you don't want a header (or footer), simply omit from the declaration of the table.
+
+For **List** based variants, the header and footer are *inside* the scrolling region. For **Stack** and **Grid** based variants, they are *outside*. (This may be configurable at some point once any scaling/performance issues are resolved.)
+
 ## Column Sorting
 
 Column sorting is available through the `tablerSort` view function.
@@ -366,17 +402,6 @@ private func hoverAction(fruitID: Fruit.ID, isHovered: Bool) {
 
 To coordinate hover with other backgrounds, such as for selection on **Stack** tables, see the demo apps.
 
-## Headless Tables
-
-Where you don't want a header, simply omit it from the declaration of the table:
-
-```swift
-var body: some View {
-    TablerList(row: row,
-               results: fruits)
-}
-```
-
 ## Moving Rows
 
 Row moving via drag and drop is available for the **List** based variants.
@@ -446,12 +471,15 @@ Stack configuration is optional.
 
 `TablerStackConfig<Element>.init` parameters:
 
-- `rowPadding: EdgeInsets` - Stack-specific default; varies by platform
-- `headerSpacing: CGFloat` - Stack-specific default; varies by platform
-- `rowSpacing: CGFloat` - Stack-specific default of 0
+- `rowPadding: EdgeInsets` - Stack-specific defaults; varies by platform
+- `headerSpacing: CGFloat` - default varies by platform
+- `footerSpacing: CGFloat` - default varies by platform
+- `rowSpacing: CGFloat` - default of 0
+- `headerFixed: Bool` - defaults to `true`
+- `footerFixed: Bool` - defaults to `false`
 - `filter: Filter?` - with a default of `nil`, indicating no filtering
 - `onHover: (Element.ID, Bool) -> Void` - defaults to `{ _,_ in }`
-- `tablePadding: EdgeInsets` - per Stack defaults
+- `tablePadding: EdgeInsets` - default varies by platform
 - `sortIndicatorForward: AnyView` - per Base defaults
 - `sortIndicatorReverse: AnyView` - per Base defaults
 - `sortIndicatorNeutral: AnyView` - per Base defaults
@@ -465,11 +493,14 @@ Grid configuration is required, where you supply a `GridItem` array.
 - `gridItems: [GridItem]` - required
 - `alignment: HorizontalAlignment` - `LazyVGrid` alignment, with a default of `.leading`
 - `itemPadding: EdgeInsets` - Grid-specific defaults, varies by platform
-- `headerSpacing: CGFloat` - Grid-specific default; varies by platform
-- `rowSpacing: CGFloat` - Grid-specific default of 0
+- `headerSpacing: CGFloat` - default varies by platform
+- `footerSpacing: CGFloat` - default varies by platform
+- `rowSpacing: CGFloat` - default of 0
+- `headerFixed: Bool` - defaults to `true`
+- `footerFixed: Bool` - defaults to `false`
 - `filter: Filter?` - with a default of `nil`, indicating no filtering
 - `onHover: (Element.ID, Bool) -> Void` - defaults to `{ _,_ in }`
-- `tablePadding: EdgeInsets` - Grid-specific default; varies by platform
+- `tablePadding: EdgeInsets` - default varies by platform
 - `sortIndicatorForward: AnyView` - per Base defaults
 - `sortIndicatorReverse: AnyView` - per Base defaults
 - `sortIndicatorNeutral: AnyView` - per Base defaults

Sources/Generated/TablerGrid+AutoInit.generated.swift

@@ -6,6 +6,7 @@ import SwiftUI
 public extension TablerGrid {
     // omitting Header
     init(_ config: Config = .init(),
+         @ViewBuilder footer: @escaping FooterContent,
          @ViewBuilder row: @escaping RowContent,
          @ViewBuilder rowBackground: @escaping RowBackground,
          @ViewBuilder rowOverlay: @escaping RowOverlay
@@ -15,6 +16,7 @@ public extension TablerGrid {
     {
         self.init(config,
                   header: { _ in EmptyView() },
+                  footer: footer,
                   row: row,
                   rowBackground: rowBackground,
                   rowOverlay: rowOverlay,
@@ -25,6 +27,7 @@ public extension TablerGrid {
     // omitting Overlay
     init(_ config: Config = .init(),
          @ViewBuilder header: @escaping HeaderContent,
+         @ViewBuilder footer: @escaping FooterContent,
          @ViewBuilder row: @escaping RowContent,
          @ViewBuilder rowBackground: @escaping RowBackground
         , results: Results
@@ -33,6 +36,7 @@ public extension TablerGrid {
     {
         self.init(config,
                   header: header,
+                  footer: footer,
                   row: row,
                   rowBackground: rowBackground,
                   rowOverlay: { _ in EmptyView() },
@@ -44,6 +48,7 @@ public extension TablerGrid {
     // omitting Background
     init(_ config: Config = .init(),
          @ViewBuilder header: @escaping HeaderContent,
+         @ViewBuilder footer: @escaping FooterContent,
          @ViewBuilder row: @escaping RowContent,
          @ViewBuilder rowOverlay: @escaping RowOverlay
         , results: Results
@@ -52,6 +57,7 @@ public extension TablerGrid {
     {
         self.init(config,
                   header: header,
+                  footer: footer,
                   row: row,
                   rowBackground: { _ in EmptyView() },
                   rowOverlay: rowOverlay,
@@ -61,6 +67,7 @@ public extension TablerGrid {
 
     // omitting Header AND Overlay
     init(_ config: Config = .init(),
+         @ViewBuilder footer: @escaping FooterContent,
          @ViewBuilder row: @escaping RowContent,
          @ViewBuilder rowBackground: @escaping RowBackground
         , results: Results
@@ -69,6 +76,7 @@ public extension TablerGrid {
     {
         self.init(config,
                   header: { _ in EmptyView() },
+                  footer: footer,
                   row: row,
                   rowBackground: rowBackground,
                   rowOverlay: { _ in EmptyView() },
@@ -78,6 +86,7 @@ public extension TablerGrid {
 
     // omitting Header AND Background
     init(_ config: Config = .init(),
+         @ViewBuilder footer: @escaping FooterContent,
          @ViewBuilder row: @escaping RowContent,
          @ViewBuilder rowOverlay: @escaping RowOverlay
         , results: Results
@@ -86,6 +95,7 @@ public extension TablerGrid {
     {
         self.init(config,
                   header: { _ in EmptyView() },
+                  footer: footer,
                   row: row,
                   rowBackground: { _ in EmptyView() },
                   rowOverlay: rowOverlay,
@@ -96,13 +106,15 @@ public extension TablerGrid {
     // omitting Background AND Overlay
     init(_ config: Config = .init(),
          @ViewBuilder header: @escaping HeaderContent,
+         @ViewBuilder footer: @escaping FooterContent,
          @ViewBuilder row: @escaping RowContent
         , results: Results
                   )
         where RowBack == EmptyView, RowOver == EmptyView
     {
         self.init(config,
                   header: header,
+                  footer: footer,
                   row: row,
                   rowBackground: { _ in EmptyView() },
                   rowOverlay: { _ in EmptyView() },
@@ -112,6 +124,7 @@ public extension TablerGrid {
 
     // omitting Header, Background, AND Overlay
     init(_ config: Config = .init(),
+         @ViewBuilder footer: @escaping FooterContent,
          @ViewBuilder row: @escaping RowContent
         , results: Results
                   )
@@ -120,6 +133,156 @@ public extension TablerGrid {
     {
         self.init(config,
                   header: { _ in EmptyView() },
+                  footer: footer,
+                  row: row,
+                  rowBackground: { _ in EmptyView() },
+                  rowOverlay: { _ in EmptyView() },
+                  results: results
+                  )
+    }
+    // omitting Footer
+    init(_ config: Config = .init(),
+         @ViewBuilder header: @escaping HeaderContent,
+         @ViewBuilder row: @escaping RowContent,
+         @ViewBuilder rowBackground: @escaping RowBackground,
+         @ViewBuilder rowOverlay: @escaping RowOverlay
+        , results: Results
+                  )
+        where Footer == EmptyView
+    {
+        self.init(config,
+                  header: header,
+                  footer: { _ in EmptyView() },
+                  row: row,
+                  rowBackground: rowBackground,
+                  rowOverlay: rowOverlay,
+                  results: results
+                  )
+    }
+
+    // omitting Header, Footer
+    init(_ config: Config = .init(),
+         @ViewBuilder row: @escaping RowContent,
+         @ViewBuilder rowBackground: @escaping RowBackground,
+         @ViewBuilder rowOverlay: @escaping RowOverlay
+        , results: Results
+                  )
+        where Header == EmptyView, Footer == EmptyView
+    {
+        self.init(config,
+                  header: { _ in EmptyView() },
+                  footer: { _ in EmptyView() },
+                  row: row,
+                  rowBackground: rowBackground,
+                  rowOverlay: rowOverlay,
+                  results: results
+                  )
+    }
+
+    // omitting Footer, Overlay
+    init(_ config: Config = .init(),
+         @ViewBuilder header: @escaping HeaderContent,
+         @ViewBuilder row: @escaping RowContent,
+         @ViewBuilder rowBackground: @escaping RowBackground
+        , results: Results
+                  )
+        where Footer == EmptyView, RowOver == EmptyView
+    {
+        self.init(config,
+                  header: header,
+                  footer: { _ in EmptyView() },
+                  row: row,
+                  rowBackground: rowBackground,
+                  rowOverlay: { _ in EmptyView() },
+                  results: results
+                  )
+
+    }
+
+    // omitting Footer, Background
+    init(_ config: Config = .init(),
+         @ViewBuilder header: @escaping HeaderContent,
+         @ViewBuilder row: @escaping RowContent,
+         @ViewBuilder rowOverlay: @escaping RowOverlay
+        , results: Results
+                  )
+        where Footer == EmptyView, RowBack == EmptyView
+    {
+        self.init(config,
+                  header: header,
+                  footer: { _ in EmptyView() },
+                  row: row,
+                  rowBackground: { _ in EmptyView() },
+                  rowOverlay: rowOverlay,
+                  results: results
+                  )
+    }
+
+    // omitting Header, Footer AND Overlay
+    init(_ config: Config = .init(),
+         @ViewBuilder row: @escaping RowContent,
+         @ViewBuilder rowBackground: @escaping RowBackground
+        , results: Results
+                  )
+        where Header == EmptyView, Footer == EmptyView, RowOver == EmptyView
+    {
+        self.init(config,
+                  header: { _ in EmptyView() },
+                  footer: { _ in EmptyView() },
+                  row: row,
+                  rowBackground: rowBackground,
+                  rowOverlay: { _ in EmptyView() },
+                  results: results
+                  )
+    }
+
+    // omitting Header, Footer AND Background
+    init(_ config: Config = .init(),
+         @ViewBuilder row: @escaping RowContent,
+         @ViewBuilder rowOverlay: @escaping RowOverlay
+        , results: Results
+                  )
+        where Header == EmptyView, Footer == EmptyView, RowBack == EmptyView
+    {
+        self.init(config,
+                  header: { _ in EmptyView() },
+                  footer: { _ in EmptyView() },
+                  row: row,
+                  rowBackground: { _ in EmptyView() },
+                  rowOverlay: rowOverlay,
+                  results: results
+                  )
+    }
+
+    // omitting Footer, Background AND Overlay
+    init(_ config: Config = .init(),
+         @ViewBuilder header: @escaping HeaderContent,
+         @ViewBuilder row: @escaping RowContent
+        , results: Results
+                  )
+        where Footer == EmptyView, RowBack == EmptyView, RowOver == EmptyView
+    {
+        self.init(config,
+                  header: header,
+                  footer: { _ in EmptyView() },
+                  row: row,
+                  rowBackground: { _ in EmptyView() },
+                  rowOverlay: { _ in EmptyView() },
+                  results: results
+                  )
+    }
+
+    // omitting Header, Footer, Background, AND Overlay
+    init(_ config: Config = .init(),
+         @ViewBuilder row: @escaping RowContent
+        , results: Results
+                  )
+
+        where Header == EmptyView, Footer == EmptyView, RowBack == EmptyView, RowOver == EmptyView
+    {
+        self.init(config,
+                  header: { _ in EmptyView() },
+                  footer: { _ in EmptyView() },
                   row: row,
                   rowBackground: { _ in EmptyView() },
                   rowOverlay: { _ in EmptyView() },