joinHTML function

Author: shish

src/microhtml.php

@@ -127,6 +127,18 @@ function emptyHTML(...$args): HTMLElement
 {
     return new EmptyHTMLElement($args);
 }
+function joinHTML(HTMLElement|string $glue, array $pieces): HTMLElement
+{
+    $out = emptyHTML();
+    $n = 0;
+    foreach ($pieces as $piece) {
+        if ($n++ > 0) {
+            $out->appendChild($glue);
+        }
+        $out->appendChild($piece);
+    }
+    return $out;
+}
 
 # https://developer.mozilla.org/en-US/docs/Web/HTML/Element
 function HTML(...$args): HTMLElement

tests/HTMLElementTest.php

@@ -11,6 +11,7 @@
 use function MicroHTML\emptyHTML;
 use function MicroHTML\DIV;
 use function MicroHTML\rawHTML;
+use function MicroHTML\joinHTML;
 
 class HTMLElementTest extends \PHPUnit\Framework\TestCase
 {
@@ -185,4 +186,16 @@ public function testRaw(): void
             P(rawHTML("<bacon>"))
         );
     }
+
+    public function testJoin(): void
+    {
+        $this->assertEquals(
+            "<p>A</p>, <p>B</p>, C",
+            joinHTML(", ", [P("A"), P("B"), "C"])
+        );
+        $this->assertEquals(
+            "<p>A</p><br /><p>B</p><br />C",
+            joinHTML(BR(), [P("A"), P("B"), "C"])
+        );
+    }
 }