Add docs TextArea::class. (#286)

docs/README.md

@@ -23,17 +23,24 @@ The following tags are currently supported:
 - [html](/docs/tag/Html.md)
 - [i](/docs/tag/I.md)
 - [img](/docs/tag/Img.md)
-- [label](/docs/tag/Label.md)
 - [li](/docs/tag/Li.md)
 - [meta](/docs/tag/Meta.md)
 - [nav](/docs/tag/Nav.md)
 - [ol](/docs/tag/Ol.md)
 - [p](/docs/tag/P.md)
 - [section](/docs/tag/Section.md)
-- [select](/docs/tag/Select.md)
 - [span](/docs/tag/Span.md)
 - [svg](/docs/tag/Svg.md)
 
+## Forms 
+
+The repository also provides a set of classes for creating forms, including:
+
+- [form](/docs/form/Form.md)
+- [label](/docs/form/Label.md)
+- [select](/docs/form/Select.md)
+- [textarea](/docs/form/Textarea.md)
+
 ## Input Tags
 
 In addition to basic `HTML` tags, the repository also supports the generation of input tags.

docs/form/TextArea.md

@@ -0,0 +1,125 @@
+# TextArea
+
+The `<textarea>` `HTML` element represents a multi-line plain-text editing control, useful when you want to allow users
+to enter a sizable amount of free-form text, for example, a comment on a review or feedback form.
+
+## Basic Usage
+
+Instantiate the `TextArea` class using `TextArea::widget()`.
+
+```php
+$textArea = TextArea::widget();
+```
+
+## Setting Attributes
+
+Use the provided methods to set specific attributes for the a element.
+
+```php
+// setting class attribute
+$textArea->class('container');
+```
+
+Or, use the `attributes` method to set multiple attributes at once.
+
+```php
+$textArea->attributes(['class' => 'container', 'style' => 'background-color: #eee;']);
+```
+
+## Adding Content
+
+If you want to include content within the `textarea` tag, use the `content` method.
+
+```php
+$textArea->content('My content');
+```
+
+## Rendering
+
+Generate the `HTML` output using the `render` method, for simple instantiation. 
+
+```php
+$html = $textArea->render();
+```
+
+Or, use the magic `__toString` method.
+
+```php
+$html = (string) $textArea;
+```
+
+## Common Use Cases
+
+Below are examples of common use cases:
+
+```php
+// adding multiple attributes
+$textArea->class('external')->content('My content');
+
+// using data attributes
+$textArea->dataAttributes(['analytics' => 'trackClick']);
+```
+
+Explore additional methods for setting various attributes such as `lang`, `name`, `style`, `title`, etc.
+
+## Attributes
+
+Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/TextArea/AttributeTest.php) for 
+comprehensive examples.
+
+The following methods are available for setting attributes:
+
+| Method            | Description                                                                                      |
+| ----------------- | ------------------------------------------------------------------------------------------------ |
+| `attributes()`    | Set multiple `attributes` at once.                                                               |
+| `autocomplete()`  | Set the `autocomplete` attribute.                                                                |
+| `autofocus()`     | Set the `autofocus` attribute.                                                                   |
+| `class()`         | Set the `class` attribute.                                                                       |
+| `cols()`          | Set the `cols` attribute.                                                                        |
+| `content()`       | Set the `content` within the `textarea` element.                                                 |
+| `dataAttributes()`| Set multiple `data-attributes` at once.                                                          |
+| `dirName()`       | Set the `dirname` attribute.                                                                     |
+| `disabled()`      | Set the `disabled` attribute.                                                                    |
+| `form()`          | Set the `form` attribute.                                                                        |
+| `id()`            | Set the `id` attribute.                                                                          |
+| `lang()`          | Set the `lang` attribute.                                                                        |
+| `name()`          | Set the `name` attribute.                                                                        |
+| `placeholder()`   | Set the `placeholder` attribute.                                                                 |
+| `readOnly()`      | Set the `readonly` attribute.                                                                    |
+| `rows()`          | Set the `rows` attribute.                                                                        |
+| `style()`         | Set the `style` attribute.                                                                       |
+| `tabIndex()`      | Set the `tabindex` attribute.                                                                    |
+| `title()`         | Set the `title` attribute.                                                                       |
+| `type()`          | Set the `type` attribute.                                                                        |
+| `value()`         | Set the `value` attribute.                                                                       |
+| `wrap()`          | Set the `wrap` attribute.                                                                        |
+
+## Custom methods
+
+Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/TextArea/CustomMethodTest.php) for
+comprehensive examples.
+
+The following methods are available for customizing the `HTML` output:
+
+| Method                       | Description                                                                           |
+| ---------------------------- | ------------------------------------------------------------------------------------- |
+| `prefix()`                   | Add text before the `textarea` element.                                               |
+| `prefixContainer()`          | Set enabled or disabled for the `prefix-container` element.                           |
+| `prefixContainerAttributes()`| Set `attributes` for the `prefix-container` element.                                  |                                            
+| `prefixContainerClass()`     | Set the `class` attribute for the `prefix-container` element.                         |
+| `prefixContainerTag()`       | Set the `tag` for the `prefix-container` element.                                     |
+| `render()`                   | Generates the `HTML` output.                                                          |
+| `template()`                 | Set the template for the `HTML` output.                                               |
+| `tokenValues()`              | Set the token values for the `HTML` output.                                           |
+| `widget()`                   | Instantiates the `TextArea::class`.                                                   |
+
+## Validate methods
+
+Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/TextArea/ValidateTest.php) for
+comprehensive examples.
+
+| Method         | Description                                                                                         |
+| -------------- | --------------------------------------------------------------------------------------------------- |
+| `maxLength()`  | Set the `maxlength` attribute.                                                                      |
+| `minLength()`  | Set the `minlength` attribute.                                                                      |
+| `required()`   | Set the `required` attribute.                                                                       |