Form components: Email, Text, Password

src/Forms/EmailInput.php

@@ -0,0 +1,103 @@
+<?php
+declare(strict_types=1);
+
+namespace Eightfold\HtmlBuilder\Forms;
+
+use Stringable;
+
+use Eightfold\HtmlBuilder\Element;
+use Eightfold\HtmlBuilder\PropertyInterface;
+
+class EmailInput implements Stringable
+{
+    // phpcs:disable
+    private string $warningId {
+        get => $this->name . '-warning';
+    }
+    // phpcs:enable
+
+    /**
+     * @var string[]
+     */
+    private array $labelProperties = [];
+
+    /**
+     * @var string[]
+     */
+    private array $inputProperties = [];
+
+    public static function create(
+        string|Stringable $label,
+        string|Stringable $name,
+        string $value = '',
+        string|PropertyInterface $warningMessage = ''
+    ): self {
+        return new self($label, $name, $value, $warningMessage);
+    }
+
+    final private function __construct(
+        private readonly string|Stringable $label,
+        private readonly string|Stringable $name,
+        private readonly string $value,
+        private readonly string|PropertyInterface $warningMessage = ''
+    ) {
+    }
+
+    public function labelProps(string ...$properties): self
+    {
+        $this->labelProperties = $properties;
+        return $this;
+    }
+
+    public function inputProps(string ...$properties): self
+    {
+        $this->inputProperties = $properties;
+        return $this;
+    }
+
+    private function warningMessage(): string|PropertyInterface
+    {
+        if ($this->warningMessage === '') {
+            return '';
+        }
+
+        if (is_string($this->warningMessage)) {
+            return Element::p($this->warningMessage)->props(
+                'id ' . $this->warningId
+            );
+        }
+
+        return $this->warningMessage->prop('id ' . $this->warningId);
+    }
+
+    public function __toString(): string
+    {
+        $elements = [];
+        $elements[] = Element::label($this->label)->props(
+            'for ' . $this->name,
+            ...$this->labelProperties
+        );
+
+        $input = Element::input()->omitEndTag()->props(
+            'type email',
+            'id ' . $this->name,
+            'name ' . $this->name,
+            'value ' . $this->value,
+            ...$this->inputProperties
+        );
+
+        $warningMessage = self::warningMessage();
+        $hasWarningMessage = ($warningMessage !== '');
+        if ($hasWarningMessage) {
+            $input = $input->prop('aria-invalid true');
+            $input = $input->prop('aria-describedby ' . $this->warningId);
+        }
+        $elements[] = $input;
+
+        if ($hasWarningMessage) {
+            $elements[] = $warningMessage;
+        }
+
+        return implode('', array_map('strval', $elements));
+    }
+}

src/Forms/Password.php

@@ -0,0 +1,124 @@
+<?php
+declare(strict_types=1);
+
+namespace Eightfold\HtmlBuilder\Forms;
+
+use Stringable;
+
+use Eightfold\HtmlBuilder\Element;
+use Eightfold\HtmlBuilder\PropertyInterface;
+
+use Eightfold\HtmlBuilder\Forms\PasswordAutocomplete;
+
+class Password implements Stringable
+{
+    // phpcs:disable
+    private string $warningId {
+        get => $this->name . '-warning';
+    }
+    // phpcs:enable
+
+    /**
+     * @var string[]
+     */
+    private array $labelProperties = [];
+
+    /**
+     * @var string[]
+     */
+    private array $inputProperties = [];
+
+
+    private PasswordAutocomplete $autocomplete = PasswordAutocomplete::CurrentPassword;
+
+    public static function create(
+        string|Stringable $label,
+        string|Stringable $name,
+        string|PropertyInterface $warningMessage = ''
+    ): self {
+        return new self($label, $name, $warningMessage);
+    }
+
+    final private function __construct(
+        private readonly string|Stringable $label,
+        private readonly string|Stringable $name,
+        private readonly string|PropertyInterface $warningMessage = ''
+    ) {
+    }
+
+    public function labelProps(string ...$properties): self
+    {
+        $this->labelProperties = $properties;
+        return $this;
+    }
+
+    public function inputProps(string ...$properties): self
+    {
+        $this->inputProperties = $properties;
+        return $this;
+    }
+
+    public function forNewPassword(): self
+    {
+        $this->autocomplete = PasswordAutocomplete::NewPassword;
+        return $this;
+    }
+
+    public function autocompleteOff(): self
+    {
+        $this->autocomplete = PasswordAutocomplete::Off;
+        return $this;
+    }
+
+    public function autocompleteOn(): self
+    {
+        $this->autocomplete = PasswordAutocomplete::On;
+        return $this;
+    }
+
+    private function warningMessage(): string|PropertyInterface
+    {
+        if ($this->warningMessage === '') {
+            return '';
+        }
+
+        if (is_string($this->warningMessage)) {
+            return Element::p($this->warningMessage)->props(
+                'id ' . $this->warningId
+            );
+        }
+
+        return $this->warningMessage->prop('id ' . $this->warningId);
+    }
+
+    public function __toString(): string
+    {
+        $elements = [];
+        $elements[] = Element::label($this->label)->props(
+            'for ' . $this->name,
+            ...$this->labelProperties
+        );
+
+        $input = Element::input()->omitEndTag()->props(
+            'type password',
+            'id ' . $this->name,
+            'name ' . $this->name,
+            'autocomplete ' . $this->autocomplete->value,
+            ...$this->inputProperties
+        );
+
+        $warningMessage = self::warningMessage();
+        $hasWarningMessage = ($warningMessage !== '');
+        if ($hasWarningMessage) {
+            $input = $input->prop('aria-invalid true');
+            $input = $input->prop('aria-describedby ' . $this->warningId);
+        }
+        $elements[] = $input;
+
+        if ($hasWarningMessage) {
+            $elements[] = $warningMessage;
+        }
+
+        return implode('', array_map('strval', $elements));
+    }
+}

src/Forms/PasswordAutocomplete.php

@@ -0,0 +1,19 @@
+<?php
+declare(strict_types=1);
+
+namespace Eightfold\HtmlBuilder\Forms;
+
+use Stringable;
+
+use Eightfold\HtmlBuilder\Element;
+use Eightfold\HtmlBuilder\PropertyInterface;
+
+use Eightfold\HtmlBuilder\Forms\SelectType;
+
+enum PasswordAutocomplete: string
+{
+    case On              = 'on';
+    case Off             = 'off';
+    case CurrentPassword = 'current-password';
+    case NewPassword     = 'new-password';
+}

src/Forms/Select.php

@@ -157,7 +157,9 @@ private function selectDropdown(): Element
     {
         $elements = [];
 
-        $hasWarningMessage = (self::warningMessage() !== '');
+        $warningMessage = self::warningMessage();
+        $hasWarningMessage = ($warningMessage !== '');
+
         foreach ($this->options as $value => $content) {
             $value  = (string) $value;
             $option = Element::option($content)->props('value ' . $value);
@@ -180,7 +182,7 @@ private function selectDropdown(): Element
                 $this->label
             )->props('for ' . $this->name, ...$this->labelProperties),
             $input,
-            self::warningMessage()
+            $warningMessage
         )->props(...$this->wrapperProperties);
     }
 
@@ -189,7 +191,9 @@ private function selectOther(): Element
         $elements = [];
         $type = $this->type === SelectType::Checkbox ? 'checkbox' : 'radio';
 
-        $hasWarningMessage = (self::warningMessage() !== '');
+        $warningMessage = self::warningMessage();
+        $hasWarningMessage = ($warningMessage !== '');
+
         foreach ($this->options as $value => $content) {
             $value = (string) $value;
             $id    = $this->name . '-' . $value;
@@ -215,7 +219,7 @@ private function selectOther(): Element
         }
 
         if ($hasWarningMessage) {
-            $elements[] = self::warningMessage();
+            $elements[] = $warningMessage;
         }
 
         return Element::fieldset(

src/Forms/TextInput.php

@@ -0,0 +1,103 @@
+<?php
+declare(strict_types=1);
+
+namespace Eightfold\HtmlBuilder\Forms;
+
+use Stringable;
+
+use Eightfold\HtmlBuilder\Element;
+use Eightfold\HtmlBuilder\PropertyInterface;
+
+class TextInput implements Stringable
+{
+    // phpcs:disable
+    private string $warningId {
+        get => $this->name . '-warning';
+    }
+    // phpcs:enable
+
+    /**
+     * @var string[]
+     */
+    private array $labelProperties = [];
+
+    /**
+     * @var string[]
+     */
+    private array $inputProperties = [];
+
+    public static function create(
+        string|Stringable $label,
+        string|Stringable $name,
+        string $value = '',
+        string|PropertyInterface $warningMessage = ''
+    ): self {
+        return new self($label, $name, $value, $warningMessage);
+    }
+
+    final private function __construct(
+        private readonly string|Stringable $label,
+        private readonly string|Stringable $name,
+        private readonly string $value,
+        private readonly string|PropertyInterface $warningMessage = ''
+    ) {
+    }
+
+    public function labelProps(string ...$properties): self
+    {
+        $this->labelProperties = $properties;
+        return $this;
+    }
+
+    public function inputProps(string ...$properties): self
+    {
+        $this->inputProperties = $properties;
+        return $this;
+    }
+
+    private function warningMessage(): string|PropertyInterface
+    {
+        if ($this->warningMessage === '') {
+            return '';
+        }
+
+        if (is_string($this->warningMessage)) {
+            return Element::p($this->warningMessage)->props(
+                'id ' . $this->warningId
+            );
+        }
+
+        return $this->warningMessage->prop('id ' . $this->warningId);
+    }
+
+    public function __toString(): string
+    {
+        $elements = [];
+        $elements[] = Element::label($this->label)->props(
+            'for ' . $this->name,
+            ...$this->labelProperties
+        );
+
+        $input = Element::input()->omitEndTag()->props(
+            'type text',
+            'id ' . $this->name,
+            'name ' . $this->name,
+            'value ' . $this->value,
+            ...$this->inputProperties
+        );
+
+        $warningMessage = self::warningMessage();
+        $hasWarningMessage = ($warningMessage !== '');
+        if ($hasWarningMessage) {
+            $input = $input->prop('aria-invalid true');
+            $input = $input->prop('aria-describedby ' . $this->warningId);
+        }
+        $elements[] = $input;
+
+        if ($hasWarningMessage) {
+            $elements[] = $warningMessage;
+        }
+
+        return implode('', array_map('strval', $elements));
+    }
+}