> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mainly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Textbox

> A text input control for entering single-line or multi-line text.

```
Textbox(placeholder="", min_len=0, max_len=16000, rows=1, regex=".*")
```

# Example

```python theme={null}
from mirmod.controls import Textbox

@wob.receiver("value", "input", control=Textbox(placeholder="a,b,c,..."))
def receive_input(self, i):
  self.values = i.split(',')
```

<Warning>The Textbox always returns a string. If you need numbers or JSON, parse the value in your receiver function or during execution.</Warning>

# Parameters

| Name        | Type   | Description                                                                                                             |
| ----------- | ------ | ----------------------------------------------------------------------------------------------------------------------- |
| placeholder | string | Hint text displayed when the field is empty.                                                                            |
| min\_len    | int    | Minimum required character count. Shows an error if not met. Default: 0.                                                |
| max\_len    | int    | Maximum allowed character count. Shows an error if exceeded. Default: 16000.                                            |
| rows        | int    | Number of visible text rows. Values greater than 1 render a resizable textarea. Default: 1.                             |
| regex       | string | Regular expression pattern for input validation. Shows an error if the input doesn't match. Default: ".\*" (any input). |