yiisoft · vjik · Mar 18, 2026 · Mar 17, 2026 · Mar 17, 2026 · Mar 17, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,7 @@
 - Chg #234: Remove tag attributes sorting (@FrankiFixx)
 - Chg #269: Rename `$options` parameter to `$attributes` in `Html::addCssClass()`, `Html::removeCssClass()`,
   `Html::addCssStyle()` and `Html::removeCssStyle()` methods (@vjik)
+- New #270: Allow passing `int`, `float` and `null` as tag content (@vjik)
 
 ## 3.13.0 March 13, 2026
 

diff --git a/src/Html.php b/src/Html.php
diff --git a/src/Tag/Base/ListTag.php b/src/Tag/Base/ListTag.php
@@ -4,6 +4,7 @@
 
 namespace Yiisoft\Html\Tag\Base;
 
+use Stringable;
 use Yiisoft\Html\Tag\Li;
 
 /**
@@ -27,14 +28,14 @@ public function items(Li ...$items): static
     }
 
     /**
-     * @param string[] $strings Array of list items as strings.
+     * @param (string|Stringable|int|float|null)[] $strings Array of list item contents.
      * @param array $attributes The tag attributes in terms of name-value pairs.
-     * @param bool $encode Whether to encode strings passed.
+     * @param bool $encode Whether to encode the item contents when rendering.
      */
     public function strings(array $strings, array $attributes = [], bool $encode = true): static
     {
         $items = array_map(
-            static fn(string $string) => (new Li())
+            static fn(string|Stringable|int|float|null $string) => (new Li())
                 ->content($string)
                 ->attributes($attributes)
                 ->encode($encode),

diff --git a/src/Tag/Base/TagContentTrait.php b/src/Tag/Base/TagContentTrait.php
@@ -17,7 +17,7 @@
     private bool $doubleEncode = true;
 
     /**
-     * @psalm-var list<string|Stringable>
+     * @psalm-var list<string|Stringable|int|float|null>
      */
     private array $content = [];
 
@@ -48,19 +48,19 @@
     }
 
     /**
-     * @param string|Stringable ...$content Tag content.
+     * @param string|Stringable|int|float|null ...$content Tag content.
      */
-    final public function content(string|Stringable ...$content): static
+    final public function content(string|Stringable|int|float|null ...$content): static
     {
         $new = clone $this;
         $new->content = array_values($content);
         return $new;
     }
 
     /**
-     * @param string|Stringable ...$content Tag content.
+     * @param string|Stringable|int|float|null ...$content Tag content.
      */
-    final public function addContent(string|Stringable ...$content): static
+    final public function addContent(string|Stringable|int|float|null ...$content): static
     {
         $new = clone $this;
         $new->content = array_merge($new->content, array_values($content));
@@ -79,7 +79,7 @@
                 $item = Html::encode($item, $this->doubleEncode);
             }
 
-            $content .= $item;
+            $content .= (string) $item;
         }
 
         return $content;

diff --git a/src/Tag/Button.php b/src/Tag/Button.php
@@ -4,6 +4,7 @@
 
 namespace Yiisoft\Html\Tag;
 
+use Stringable;
 use Yiisoft\Html\Tag\Base\NormalTag;
 use Yiisoft\Html\Tag\Base\TagContentTrait;
 
@@ -14,21 +15,21 @@ final class Button extends NormalTag
 {
     use TagContentTrait;
 
-    public static function button(string $content = ''): self
+    public static function button(string|Stringable|int|float|null $content = ''): self
     {
         $button = (new self())->content($content);
         $button->attributes['type'] = 'button';
         return $button;
     }
 
-    public static function submit(string $content = ''): self
+    public static function submit(string|Stringable|int|float|null $content = ''): self
     {
         $button = (new self())->content($content);
         $button->attributes['type'] = 'submit';
         return $button;
     }
 
-    public static function reset(string $content = ''): self
+    public static function reset(string|Stringable|int|float|null $content = ''): self
     {
         $button = (new self())->content($content);
         $button->attributes['type'] = 'reset';

diff --git a/src/Tag/Optgroup.php b/src/Tag/Optgroup.php
@@ -27,7 +27,7 @@ public function options(Option ...$options): self
     /**
      * Options as a set of value-content pairs.
      *
-     * @param string[] $data Value-content set of options.
+     * @param (string|Stringable|int|float|null)[] $data Value-content set of options.
      * @param bool $encode Whether to encode option content.
      * @param array[] $optionsAttributes Array of option attribute sets indexed by option values from {@see $data}.
      */

diff --git a/src/Tag/Script.php b/src/Tag/Script.php
@@ -23,12 +23,12 @@ final class Script extends NormalTag
     /**
      * @link https://www.w3.org/TR/html52/semantics-scripting.html#script-content-restrictions
      *
-     * @param string $content Tag content.
+     * @param string|Stringable $content Tag content.
      */
-    public function content(string $content): self
+    public function content(string|Stringable $content): self
     {
         $new = clone $this;
-        $new->content = $content;
+        $new->content = (string) $content;
         return $new;
     }
 

diff --git a/src/Tag/Select.php b/src/Tag/Select.php
@@ -17,7 +17,7 @@
  *
  * @link https://www.w3.org/TR/html52/sec-forms.html#the-select-element
  *
- * @psalm-type OptionsData = array<array-key, string|array<array-key,string>>
+ * @psalm-type OptionsData = array<array-key, string|Stringable|int|float|null|array<array-key,string|Stringable|int|float|null>>
  */
 final class Select extends NormalTag
 {
@@ -71,7 +71,7 @@
     */
    public function values(iterable $values): self
    {
        $values = is_array($values) ? $values : iterator_to_array($values);

        return $this->value(...$values);
    }
@@ -168,10 +168,10 @@
     }
 
     /**
-     * @param string|null $text Text of the option that has dummy value and is rendered
+     * @param string|Stringable|int|float|null $text Text of the option that has dummy value and is rendered
      * as an invitation to select a value.
      */
-    public function prompt(?string $text): self
+    public function prompt(string|Stringable|int|float|null $text): self
     {
         $new = clone $this;
         $new->prompt = $text === null ? null : (new Option())
@@ -273,7 +273,7 @@

    protected function before(): string
    {
        $name = (string) ($this->attributes['name'] ?? '');
        if (
            empty($name)
            || (

diff --git a/src/Tag/Style.php b/src/Tag/Style.php
@@ -4,6 +4,7 @@
 
 namespace Yiisoft\Html\Tag;
 
+use Stringable;
 use Yiisoft\Html\Tag\Base\NormalTag;
 
 /**
@@ -14,12 +15,12 @@ final class Style extends NormalTag
     private string $content = '';
 
     /**
-     * @param string $content Tag content.
+     * @param string|Stringable $content Tag content.
      */
-    public function content(string $content): self
+    public function content(string|Stringable $content): self
     {
         $new = clone $this;
-        $new->content = $content;
+        $new->content = (string) $content;
         return $new;
     }
 

diff --git a/src/Tag/Table.php b/src/Tag/Table.php
@@ -4,6 +4,7 @@
 
 namespace Yiisoft\Html\Tag;
 
+use Stringable;
 use Yiisoft\Html\Tag\Base\NormalTag;
 
 /**
@@ -44,7 +45,7 @@ public function caption(?Caption $caption): self
         return $new;
     }
 
-    public function captionString(string $content, bool $encode = true): self
+    public function captionString(string|Stringable|int|float|null $content, bool $encode = true): self
     {
         $caption = (new Caption())->content($content);
         if (!$encode) {

diff --git a/src/Tag/Textarea.php b/src/Tag/Textarea.php
@@ -40,9 +40,9 @@ public function columns(?int $count): self
     }
 
     /**
-     * @param string|string[]|Stringable|null $value
+     * @param string|string[]|Stringable|int|float|null $value
      */
-    public function value(string|Stringable|array|null $value): self
+    public function value(string|Stringable|int|float|array|null $value): self
     {
         $content = is_array($value)
             ? implode("\n", $value)

diff --git a/src/Tag/Tr.php b/src/Tag/Tr.php
@@ -4,6 +4,7 @@
 
 namespace Yiisoft\Html\Tag;
 
+use Stringable;
 use Yiisoft\Html\Tag\Base\NormalTag;
 use Yiisoft\Html\Tag\Base\TableCellTag;
 
@@ -58,7 +59,7 @@ public function addDataStrings(array $strings, array $attributes = [], bool $enc
     }
 
     /**
-     * @param string[] $strings Array of header cells ({@see Th}) as strings.
+     * @param (string|Stringable|int|float|null)[] $strings Array of header cells ({@see Th}) contents.
      * @param array $attributes The tag attributes in terms of name-value pairs.
      * @param bool $encode Whether to encode strings passed.
      */
@@ -68,7 +69,7 @@ public function headerStrings(array $strings, array $attributes = [], bool $enco
     }
 
     /**
-     * @param string[] $strings Array of header cells ({@see Th}) as strings.
+     * @param (string|Stringable|int|float|null)[] $strings Array of header cells ({@see Th}) contents.
      * @param array $attributes The tag attributes in terms of name-value pairs.
      * @param bool $encode Whether to encode strings passed.
      */
@@ -90,14 +91,14 @@ protected function getName(): string
     }
 
     /**
-     * @param string[] $strings
+     * @param (string|Stringable|int|float|null)[] $strings
      *
      * @return Td[]
      */
     private function makeDataCells(array $strings, array $attributes, bool $encode): array
     {
         return array_map(
-            static fn(string $string) => (new Td())
+            static fn(string|Stringable|int|float|null $string) => (new Td())
                 ->content($string)
                 ->attributes($attributes)
                 ->encode($encode),
@@ -106,14 +107,14 @@ private function makeDataCells(array $strings, array $attributes, bool $encode):
     }
 
     /**
-     * @param string[] $strings
+     * @param (string|Stringable|int|float|null)[] $strings
      *
      * @return Th[]
      */
     private function makeHeaderCells(array $strings, array $attributes, bool $encode): array
     {
         return array_map(
-            static fn(string $string) => (new Th())
+            static fn(string|Stringable|int|float|null $string) => (new Th())
                 ->content($string)
                 ->attributes($attributes)
                 ->encode($encode),