Add optional wrap parameter to BooleanInputTag::label() (#224)

vjik · samdark · arogachev · web-flow · commit d56184da7ec1 · 2024-10-24T12:23:45.000+05:00
* Add optional `wrap` parameter to `BooleanInputTag::label()`

* Update CHANGELOG.md

Co-authored-by: Alexander Makarov &lt;sam@rmcreative.ru&gt;

* Update CHANGELOG.md

Co-authored-by: Alexey Rogachev &lt;arogachev90@gmail.com&gt;

* Update src/Tag/Base/BooleanInputTag.php

Co-authored-by: Alexey Rogachev &lt;arogachev90@gmail.com&gt;

* Update src/Tag/Base/BooleanInputTag.php

Co-authored-by: Alexey Rogachev &lt;arogachev90@gmail.com&gt;

* fix

---------

Co-authored-by: Alexander Makarov &lt;sam@rmcreative.ru&gt;
Co-authored-by: Alexey Rogachev &lt;arogachev90@gmail.com&gt;
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,8 @@
 - Enh #220: Add `non-empty-string` psalm type of `Html::generateId()` method result (@vjik)
 - Enh #220: Add `non-empty-string|null` psalm type of `Tag::id()` method parameter (@vjik)
 - Enh #222: Bump minimal PHP version to 8.1 and refactor (@vjik)
+- New #224: Add optional `wrap` parameter to `BooleanInputTag::label()` method that controls whether to wrap input tag
+  with label tag or place them aside (@vjik)  
 
 ## 3.7.0 September 18, 2024
 
diff --git a/src/Tag/Base/BooleanInputTag.php b/src/Tag/Base/BooleanInputTag.php
@@ -36,12 +36,18 @@ final public function checked(bool $checked = true): static
      *
      * @param string|null $label Input label.
      * @param array $attributes Name-value set of label attributes.
+     * @param bool $wrap Whether to wrap input with label tag. If set to `false`, label will be rendered aside with
+     * input.
      */
-    final public function label(?string $label, array $attributes = []): static
-    {
+    final public function label(
+        ?string $label,
+        array $attributes = [],
+        bool $wrap = true,
+    ): static {
         $new = clone $this;
         $new->label = $label;
         $new->labelAttributes = $attributes;
+        $new->labelWrap = $wrap;
         return $new;
     }
 
diff --git a/tests/Tag/Base/BooleanInputTagTest.php b/tests/Tag/Base/BooleanInputTagTest.php
@@ -61,6 +61,16 @@ public function testLabel(string $expected, ?string $label, array $attributes):
         );
     }
 
+    public function testLabelNoWrap(): void
+    {
+        $this->assertSame(
+            '<input type="test" id="ID"> <label for="ID">Voronezh</label>',
+            (string) TestBooleanInputTag::tag()
+                ->id('ID')
+                ->label('Voronezh', wrap: false),
+        );
+    }
+
     public function testLabelWithId(): void
     {
         $this->assertSame(
