# Textarea

The HTML textarea tag, implemented in Ruby.

If you want to use the `textarea` in context of a matestack `form`, please use `form_textarea` documented [here](https://docs.matestack.io/matestack-ui-core/1.5.0/components-api/reactive-core-components/form)

## Parameters

This component can take various optional configuration params and either yield content or display what gets passed to the `text` configuration param.

### text (optional)

Expects a string which will be displayed as the content inside the `<sub>` tag.

### HMTL attributes (optional)

This component accepts all the canonical [HTML global attributes](https://www.w3schools.com/tags/ref_standardattributes.asp) like `id` or `class`.

## Examples

### Example 1: Yield a given block

```ruby
textarea id: "foo", class: "bar", cols: 2, maxlength: 20 do
  plain 'Hello World!'
end
```

returns

```markup
<textarea type="text" id="foo" class="bar" cols="2" maxlength="20">Hello World!</textarea>
```

### Example 2: Render options\[:text] param

```ruby
textarea id: "foo", class: "bar", cols: 2, maxlength: 20, text: 'Hello World!'
```

returns

```markup
<textarea type="text" id="foo" class="bar" cols="2" maxlength="20">Hello World!</textarea>
```