"description" attribute support

Classes/Form/AbstractFormField.php

@@ -102,6 +102,9 @@ public function build(): array
             'exclude' => intval($this->getExclude()),
             'config' => $configuration
         ];
+        if (($description = $this->getDescription()) && $description !== null) {
+            $fieldStructureArray['description'] = $this->getDescription();
+        }
         if (($displayCondition = $this->getDisplayCondition())) {
             $fieldStructureArray['displayCond'] = $displayCondition;
         }

Classes/ViewHelpers/Field/AbstractFieldViewHelper.php

@@ -30,6 +30,7 @@ public function initializeArguments(): void
             'the name of the field.'
         );
         $this->registerArgument('default', 'string', 'Default value for this attribute');
+        $this->registerArgument('description', 'string', 'Field description', false);
         $this->registerArgument(
             'native',
             'boolean',
@@ -161,6 +162,7 @@ protected static function getPreparedComponent(
             static::getExtensionNameFromRenderingContextOrArguments($renderingContext, $arguments)
         );
         $component->setDefault($arguments['default']);
+        $component->setDescription($arguments['description']);
         $component->setRequired($arguments['required']);
         $component->setExclude($arguments['exclude']);
         $component->setEnabled($arguments['enabled']);

Tests/Unit/Form/Field/TextTest.php

@@ -41,6 +41,15 @@ public function canChainSetterForEnableRichText()
         $this->assertTrue($instance->getEnableRichText());
     }
 
+    public function testBuildDescription()
+    {
+        $subject = Text::create(['name' => 'test', 'description' => 'desc']);
+        $config = $subject->build();
+        $this->assertArrayHasKey('label', $config);
+        $this->assertArrayHasKey('description', $config);
+        $this->assertEquals('desc', $config['description']);
+    }
+
     public function testBuildConfigurationWithRteResolving(): void
     {
         $subject = $this->getMockBuilder(Text::class)

Tests/Unit/Form/FieldTest.php

@@ -60,6 +60,20 @@ public function testBuildCreatesExpectedTcaArray(): void
         );
     }
 
+    public function testBuildSupportsDescription(): void
+    {
+        $settings = [
+            'type' => 'input',
+            'name' => 'test',
+            'description' => 'desc',
+        ];
+        $subject = Field::create($settings);
+        $output = $subject->build();
+
+        self::assertArrayHasKey('description', $output);
+        self::assertEquals('desc', $output['description']);
+    }
+
     public function testCanGetAndSetType(): void
     {
         $this->assertGetterAndSetterWorks('type', 'sometype', null, true);

Tests/Unit/ViewHelpers/Field/Inline/FalViewHelperTest.php

@@ -29,6 +29,23 @@ public function createsExpectedComponent()
         $this->assertInstanceOf(Fal::class, $component);
     }
 
+    /**
+     * @test
+     */
+    public function supportsDescription()
+    {
+        $arguments = [
+            'name' => 'test',
+            'description' => 'testdesc'
+        ];
+        $instance = $this->buildViewHelperInstance($arguments, []);
+        $component = $instance->getComponent(
+            $this->renderingContext,
+            $this->buildViewHelperArguments($instance, $arguments)
+        );
+        $this->assertEquals($arguments['description'], $component->getDescription());
+    }
+
     /**
      * @test
      */

Tests/Unit/ViewHelpers/Field/TextViewHelperTest.php

@@ -14,6 +14,20 @@ class TextViewHelperTest extends AbstractFieldViewHelperTestCase
         'name' => 'test',
     ];
 
+    /**
+     * @test
+     */
+    public function supportsDescription()
+    {
+        $arguments = ['name' => 'test', 'description' => 'testdesc'];
+        $instance = $this->buildViewHelperInstance($arguments);
+        $component = $instance->getComponent(
+            $this->getInaccessiblePropertyValue($instance, 'renderingContext'),
+            $this->getInaccessiblePropertyValue($instance, 'arguments')
+        );
+        $this->assertSame($arguments['description'], $component->getDescription());
+    }
+
     /**
      * @test
      */

Tests/Unit/ViewHelpers/FieldViewHelperTest.php

@@ -16,4 +16,18 @@ class FieldViewHelperTest extends AbstractFieldViewHelperTestCase
         'name' => 'test',
         'type' => 'input',
     ];
+
+    /**
+     * @test
+     */
+    public function supportsDescription()
+    {
+        $arguments = ['name' => 'test', 'type' => 'input', 'description' => 'testdesc'];
+        $instance = $this->buildViewHelperInstance($arguments);
+        $component = $instance->getComponent(
+            $this->getInaccessiblePropertyValue($instance, 'renderingContext'),
+            $this->getInaccessiblePropertyValue($instance, 'arguments')
+        );
+        $this->assertSame($arguments['description'], $component->getDescription());
+    }
 }