Add id modifier.

Part of #27.
ClutchEngineering · Aug 3, 2024 · 7a561b9 · 7a561b9
1 parent 7d1ada7
commit 7a561b9
Show file tree

Hide file tree

Showing 5 changed files with 42 additions and 1 deletion.
diff --git a/Sources/Slipstream/Views/Fundamentals/AttributeModifier.swift b/Sources/Slipstream/Views/Fundamentals/AttributeModifier.swift
@@ -26,6 +26,13 @@ public struct AttributeModifier<T: View>: ViewModifier {
 
   /// A W3C global attribute, as defined in [3.2.3 Global attributes](https://html.spec.whatwg.org/multipage/dom.html#global-attributes).
   public enum GlobalAttribute: String {
+    /// The id attribute specifies its element's unique identifier (ID).
+    ///
+    /// There are no other restrictions on what form an ID can take; in particular,
+    /// IDs can consist of just digits, start with a digit, start with an
+    /// underscore, consist of just punctuation, etc.
+    case id
+
     /// The lang attribute specifies the primary language for the view's contents
     /// and for any of the view's attributes that contain text. Its value must be a
     /// valid [BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag),

diff --git a/Sources/Slipstream/Views/W3C/Attributes/View+id.swift b/Sources/Slipstream/Views/W3C/Attributes/View+id.swift
@@ -0,0 +1,11 @@
+extension View {
+  /// Sets the element's unique identifier (ID)..
+  ///
+  /// - Parameter identifier: There are no other restrictions on what form an ID can take; in particular,
+  /// IDs can consist of just digits, start with a digit, start with an
+  /// underscore, consist of just punctuation, etc.
+  @available(iOS 17.0, macOS 14.0, *)
+  public func id(_ identifier: String) -> some View {
+    return modifier(AttributeModifier(.id, value: identifier))
+  }
+}
diff --git a/Tests/SlipstreamTests/Attributes/IDTests.swift b/Tests/SlipstreamTests/Attributes/IDTests.swift
@@ -0,0 +1,22 @@
+import Testing
+
+import Slipstream
+
+private struct IDView: View {
+  var body: some View {
+    HTML {
+      Text("Bonjour!")
+    }
+    .id("root")
+  }
+}
+
+struct IDTests {
+  @Test func french() throws {
+    try #expect(renderHTML(IDView()) == """
+<html id="root">
+ Bonjour!
+</html>
+""")
+  }
+}
diff --git a/Tests/SlipstreamTests/Sites/CatalogSiteTests.swift b/Tests/SlipstreamTests/Sites/CatalogSiteTests.swift
@@ -19,6 +19,7 @@ private struct CatalogSite: View {
           Text("Hello, world!")
         }
       }
+      .id("root")
     }
   }
 }
@@ -34,7 +35,7 @@ struct CatalogSiteTests {
   <meta name="description" content="Slipstream is a static website generator built in the Swift programming language and compatible with Tailwind CSS." />
   <link rel="stylesheet" href="/css/bootstrap.css" />
  </head>
- <body>
+ <body id="root">
   <div>
    Hello, world!
   </div>

diff --git a/.../Views/TextInputAndOutput/TextTests.swift → Tests/SlipstreamTests/TextTests.swift b/.../Views/TextInputAndOutput/TextTests.swift → Tests/SlipstreamTests/TextTests.swift