Add basic Table elements.

.github/workflows/package-test.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: macos-latest
     steps:
       - name: Select Xcode
-        run: sudo xcode-select -s "/Applications/Xcode_16_beta_4.app"
+        run: sudo xcode-select -s "/Applications/Xcode_16_beta_5.app"
       - name: Get swift version
         run: swift --version
       - uses: actions/checkout@v4

Sources/Slipstream/Documentation.docc/Guides/SlipstreamForWebDevelopers.md

@@ -153,16 +153,16 @@ provided below is an organized table of W3C HTML tags and their equivalent Slips
 
  W3C tag | Slipstream view
 :--------|:----------------
-[`<table>`](https://html.spec.whatwg.org/multipage/sections.html#the-table-element) | [Not implemented yet](https://github.com/jverkoey/slipstream/issues/25)
+[`<table>`](https://html.spec.whatwg.org/multipage/sections.html#the-table-element) | ``Table``
 [`<caption>`](https://html.spec.whatwg.org/multipage/sections.html#the-caption-element) | [Not implemented yet](https://github.com/jverkoey/slipstream/issues/25)
 [`<colgroup>`](https://html.spec.whatwg.org/multipage/sections.html#the-colgroup-element) | [Not implemented yet](https://github.com/jverkoey/slipstream/issues/25)
 [`<col>`](https://html.spec.whatwg.org/multipage/sections.html#the-col-element) | [Not implemented yet](https://github.com/jverkoey/slipstream/issues/25)
-[`<tbody>`](https://html.spec.whatwg.org/multipage/sections.html#the-tbody-element) | [Not implemented yet](https://github.com/jverkoey/slipstream/issues/25)
-[`<thead>`](https://html.spec.whatwg.org/multipage/sections.html#the-thead-element) | [Not implemented yet](https://github.com/jverkoey/slipstream/issues/25)
+[`<tbody>`](https://html.spec.whatwg.org/multipage/sections.html#the-tbody-element) | ``TableBody``
+[`<thead>`](https://html.spec.whatwg.org/multipage/sections.html#the-thead-element) | ``TableHeader``
 [`<tfoot>`](https://html.spec.whatwg.org/multipage/sections.html#the-tfoot-element) | [Not implemented yet](https://github.com/jverkoey/slipstream/issues/25)
-[`<tr>`](https://html.spec.whatwg.org/multipage/sections.html#the-tr-element) | [Not implemented yet](https://github.com/jverkoey/slipstream/issues/25)
-[`<td>`](https://html.spec.whatwg.org/multipage/sections.html#the-td-element) | [Not implemented yet](https://github.com/jverkoey/slipstream/issues/25)
-[`<th>`](https://html.spec.whatwg.org/multipage/sections.html#the-th-element) | [Not implemented yet](https://github.com/jverkoey/slipstream/issues/25)
+[`<tr>`](https://html.spec.whatwg.org/multipage/sections.html#the-tr-element) | ``TableRow``
+[`<td>`](https://html.spec.whatwg.org/multipage/sections.html#the-td-element) | ``TableCell``
+[`<th>`](https://html.spec.whatwg.org/multipage/sections.html#the-th-element) | ``TableHeaderCell``
 
 ### Forms
 

Sources/Slipstream/Documentation.docc/W3C/W3CViews.md

@@ -60,6 +60,15 @@ The complete W3C HTML elements standard can be found [here](https://html.spec.wh
 - ``Image``
 - ``RawHTML``
 
+### Tabular data
+
+- ``Table``
+- ``TableHeader``
+- ``TableHeaderCell``
+- ``TableBody``
+- ``TableRow``
+- ``TableCell``
+
 ### Forms
 
 - ``Form``

Sources/Slipstream/W3C/Elements/TabularData/Table.swift

@@ -0,0 +1,29 @@
+/// A view that represents data with more than one dimension, in
+/// the form of a table.
+///
+/// ```swift
+/// struct MySiteContent: View {
+///   var body: some View {
+///     Body {
+///       Table {
+///         DOMString("Hello, world!")
+///       }
+///     }
+///   }
+/// }
+/// ```
+///
+/// - SeeAlso: W3C [table](https://html.spec.whatwg.org/multipage/tables.html#the-table-element) specification.
+@available(iOS 17.0, macOS 14.0, *)
+public struct Table<Content>: W3CElement where Content: View {
+  @_documentation(visibility: private)
+  public let tagName: String = "table"
+
+  @_documentation(visibility: private)
+  @ViewBuilder public let content: () -> Content
+
+  /// Creates a table.
+  public init(@ViewBuilder content: @escaping () -> Content) {
+    self.content = content
+  }
+}

Sources/Slipstream/W3C/Elements/TabularData/TableBody.swift

@@ -0,0 +1,18 @@
+/// A view that represents a block of rows that consist of a body of
+/// data for the parent table view, if the ``TableBody`` has a
+/// parent and it is a table.
+///
+/// - SeeAlso: W3C [tbody](https://html.spec.whatwg.org/multipage/tables.html#the-tbody-element) specification.
+@available(iOS 17.0, macOS 14.0, *)
+public struct TableBody<Content>: W3CElement where Content: View {
+  @_documentation(visibility: private)
+  public let tagName: String = "tbody"
+
+  @_documentation(visibility: private)
+  @ViewBuilder public let content: () -> Content
+
+  /// Creates a table body.
+  public init(@ViewBuilder content: @escaping () -> Content) {
+    self.content = content
+  }
+}

Sources/Slipstream/W3C/Elements/TabularData/TableCell.swift

@@ -0,0 +1,16 @@
+/// A view that represents a data cell in a table.
+///
+/// - SeeAlso: W3C [td](https://html.spec.whatwg.org/multipage/tables.html#the-td-element) specification.
+@available(iOS 17.0, macOS 14.0, *)
+public struct TableCell<Content>: W3CElement where Content: View {
+  @_documentation(visibility: private)
+  public let tagName: String = "td"
+
+  @_documentation(visibility: private)
+  @ViewBuilder public let content: () -> Content
+
+  /// Creates a table cell.
+  public init(@ViewBuilder content: @escaping () -> Content) {
+    self.content = content
+  }
+}

Sources/Slipstream/W3C/Elements/TabularData/TableHeader.swift

@@ -0,0 +1,18 @@
+/// A view that represents the block of rows that consist of the column
+/// labels (headers) and any ancillary non-header cells for the parent
+/// table element, if the view has a parent and it is a table.
+///
+/// - SeeAlso: W3C [thead](https://html.spec.whatwg.org/multipage/tables.html#the-thead-element) specification.
+@available(iOS 17.0, macOS 14.0, *)
+public struct TableHeader<Content>: W3CElement where Content: View {
+  @_documentation(visibility: private)
+  public let tagName: String = "thead"
+
+  @_documentation(visibility: private)
+  @ViewBuilder public let content: () -> Content
+
+  /// Creates a table header.
+  public init(@ViewBuilder content: @escaping () -> Content) {
+    self.content = content
+  }
+}

Sources/Slipstream/W3C/Elements/TabularData/TableHeaderCell.swift

@@ -0,0 +1,16 @@
+/// A view that represents a header cell in a table.
+///
+/// - SeeAlso: W3C [th](https://html.spec.whatwg.org/multipage/tables.html#the-th-element) specification.
+@available(iOS 17.0, macOS 14.0, *)
+public struct TableHeaderCell<Content>: W3CElement where Content: View {
+  @_documentation(visibility: private)
+  public let tagName: String = "th"
+
+  @_documentation(visibility: private)
+  @ViewBuilder public let content: () -> Content
+
+  /// Creates a table header cell.
+  public init(@ViewBuilder content: @escaping () -> Content) {
+    self.content = content
+  }
+}

Sources/Slipstream/W3C/Elements/TabularData/TableRow.swift

@@ -0,0 +1,16 @@
+/// A view that represents a row of cells in a table.
+///
+/// - SeeAlso: W3C [tr](https://html.spec.whatwg.org/multipage/tables.html#the-tr-element) specification.
+@available(iOS 17.0, macOS 14.0, *)
+public struct TableRow<Content>: W3CElement where Content: View {
+  @_documentation(visibility: private)
+  public let tagName: String = "tr"
+
+  @_documentation(visibility: private)
+  @ViewBuilder public let content: () -> Content
+
+  /// Creates a table row.
+  public init(@ViewBuilder content: @escaping () -> Content) {
+    self.content = content
+  }
+}

Tests/SlipstreamTests/W3C/TabularData/TableBodyTests.swift

@@ -0,0 +1,19 @@
+import Testing
+
+import Slipstream
+
+struct TableBodyTests {
+  @Test func emptyBlock() throws {
+    try #expect(renderHTML(TableBody {}) == "<tbody></tbody>")
+  }
+
+  @Test func withText() throws {
+    try #expect(renderHTML(TableBody {
+      DOMString("Hello, world!")
+    }) == """
+<tbody>
+ Hello, world!
+</tbody>
+""")
+  }
+}

Tests/SlipstreamTests/W3C/TabularData/TableCellTests.swift

@@ -0,0 +1,17 @@
+import Testing
+
+import Slipstream
+
+struct TableCellTests {
+  @Test func emptyBlock() throws {
+    try #expect(renderHTML(TableCell {}) == "<td></td>")
+  }
+
+  @Test func withText() throws {
+    try #expect(renderHTML(TableCell {
+      DOMString("Hello, world!")
+    }) == """
+<td>Hello, world!</td>
+""")
+  }
+}

Tests/SlipstreamTests/W3C/TabularData/TableHeaderCellTests.swift

@@ -0,0 +1,17 @@
+import Testing
+
+import Slipstream
+
+struct TableHeaderCellTests {
+  @Test func emptyBlock() throws {
+    try #expect(renderHTML(TableHeaderCell {}) == "<th></th>")
+  }
+
+  @Test func withText() throws {
+    try #expect(renderHTML(TableHeaderCell {
+      DOMString("Hello, world!")
+    }) == """
+<th>Hello, world!</th>
+""")
+  }
+}

Tests/SlipstreamTests/W3C/TabularData/TableHeaderTests.swift

@@ -0,0 +1,19 @@
+import Testing
+
+import Slipstream
+
+struct TableHeaderTests {
+  @Test func emptyBlock() throws {
+    try #expect(renderHTML(TableHeader {}) == "<thead></thead>")
+  }
+
+  @Test func withText() throws {
+    try #expect(renderHTML(TableHeader {
+      DOMString("Hello, world!")
+    }) == """
+<thead>
+ Hello, world!
+</thead>
+""")
+  }
+}

Tests/SlipstreamTests/W3C/TabularData/TableRowTests.swift

@@ -0,0 +1,19 @@
+import Testing
+
+import Slipstream
+
+struct TableRowTests {
+  @Test func emptyBlock() throws {
+    try #expect(renderHTML(TableRow {}) == "<tr></tr>")
+  }
+
+  @Test func withText() throws {
+    try #expect(renderHTML(TableRow {
+      DOMString("Hello, world!")
+    }) == """
+<tr>
+ Hello, world!
+</tr>
+""")
+  }
+}

Tests/SlipstreamTests/W3C/TabularData/TableTests.swift

@@ -0,0 +1,19 @@
+import Testing
+
+import Slipstream
+
+struct TableTests {
+  @Test func emptyBlock() throws {
+    try #expect(renderHTML(Table {}) == "<table></table>")
+  }
+
+  @Test func withText() throws {
+    try #expect(renderHTML(Table {
+      DOMString("Hello, world!")
+    }) == """
+<table>
+ Hello, world!
+</table>
+""")
+  }
+}