Use new %TagClass%() instead of %TagClass%::tag()

CHANGELOG.md

@@ -1,10 +1,15 @@
 # Yii HTML Change Log
 
+## 3.13.0
+
+- Enh #243: Use `new tagName()` instead of static constructor `tagName::tag()` (@razvbir)
+
 ## 3.12.1 under development
 
 - New #260: Add `$attributes` parameter to `Html::li()` method (@gauravkumar2525)
 - Enh #261: Enhance `RadioList::addRadioWrapClass()` method for cleaner class addition (@vjik)
 - Enh #263: Explicitly import classes and constants in "use" section (@mspirkov)
+- Enh #243: Use `new tagName()` without parentheses instead of static constructor `tagName::tag()` (@razvbir)
 
 ## 3.12.0 December 13, 2025
 

README.md

@@ -85,9 +85,9 @@ Tag classes allow working with a tag as an object and then get an HTML code by u
 to string. For example, the following code:
 
 ```php
-echo \Yiisoft\Html\Tag\Div::tag()
+echo new \Yiisoft\Html\Tag\Div()
     ->content(
-        \Yiisoft\Html\Tag\A::tag()
+        new \Yiisoft\Html\Tag\A()
             ->mailto('info@example.com')
             ->content('contact us')
             ->render()
@@ -108,7 +108,7 @@ echo \Yiisoft\Html\Tag\Div::tag()
 To generate custom tags, use the `CustomTag` class. For example, the following code:
 
 ```php
-echo \Yiisoft\Html\Tag\CustomTag::name('b')
+echo new \Yiisoft\Html\Tag\CustomTag('b')
     ->content('text')
     ->attribute('title', 'Important');
 ```
@@ -166,7 +166,7 @@ complex HTML in simple PHP.
 Represents a group of buttons.
 
 ```php
-echo \Yiisoft\Html\Widget\ButtonGroup::create()
+echo new \Yiisoft\Html\Widget\ButtonGroup()
    ->buttons(
        \Yiisoft\Html\Html::resetButton('Reset Data'),
        \Yiisoft\Html\Html::resetButton('Send'),
@@ -189,7 +189,7 @@ Result will be:
 Represents a list of checkboxes.
 
 ```php
-echo \Yiisoft\Html\Widget\CheckboxList\CheckboxList::create('count')
+echo new \Yiisoft\Html\Widget\CheckboxList\CheckboxList('count')
     ->items([1 => 'One', 2 => 'Two', 5 => 'Five'])
     ->uncheckValue(0)
     ->value(2, 5)
@@ -212,7 +212,7 @@ Result will be:
 Represents a list of radio buttons.
 
 ```php
-echo \Yiisoft\Html\Widget\RadioList\RadioList::create('count')
+echo new \Yiisoft\Html\Widget\RadioList\RadioList('count')
     ->items([1 => 'One', 2 => 'Two', 5 => 'Five'])
     ->uncheckValue(0)
     ->value(2)

composer-require-checker.json

@@ -1,6 +1,7 @@
 {
     "symbol-whitelist": [
-        "BackedEnum"
+        "BackedEnum",
+        "Deprecated"
     ],
     "php-core-extensions": [
         "Core",

src/Attribute/Deprecated.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Yiisoft\Html\Attribute;
+
+use Attribute;
+
+use const E_USER_DEPRECATED;
+
+#[Attribute]
+final class Deprecated
+{
+    public function __construct(
+        public readonly ?string $message,
+        public readonly ?string $since,
+    ) {
+        trigger_error($message ?? '', E_USER_DEPRECATED);
+    }
+}
+
+if (!class_exists('Deprecated')) {
+    class_alias(Deprecated::class, 'Deprecated');
+}