> ## Documentation Index
> Fetch the complete documentation index at: https://neo.tvk.company/llms.txt
> Use this file to discover all available pages before exploring further.
# Text Area
> A multi-line text input widget with auto-resizing, manual resizing, and advanced keyboard shortcuts for capturing longer text content.
## Examples
```dart With Label and Description lines theme={null}
NeoTextArea(
controller: controller, // Using e.g. useTextEditingController() hook
label: "Comments",
description: "Share your thoughts and feedback",
onChanged: (value) {
// Handle input
},
),
```
```dart Cmd/Ctrl+Enter to Submit (Editor-style) lines theme={null}
NeoTextArea(
controller: controller, // Using e.g. useTextEditingController() hook
placeholder: "Write your document...",
minLines: 8,
maxLines: 20,
onSubmitted: (value) {
NeoLogger.trace("Document saved: $value");
},
),
```
```dart Enter to Submit (Chat-style) lines theme={null}
NeoTextArea(
controller: controller, // Using e.g. useTextEditingController() hook
placeholder: "Type a message...",
minLines: 1,
maxLines: 5,
submitOnEnter: true,
maintainFocusOnSubmit: true,
showResizeHandle: false,
onSubmitted: (value) {
NeoLogger.trace("Message sent: $value");
controller.clear();
},
),
```
```dart With Error State lines theme={null}
NeoTextArea(
controller: controller, // Using e.g. useTextEditingController() hook
label: "Product Description",
placeholder: "Describe your product...",
errorText: controller.text.isEmpty ? "Description is required" : null,
onChanged: (value) {
// Trigger rebuild to update error state
},
),
```
```dart Disabled State lines theme={null}
NeoTextArea(
controller: controller, // Using e.g. useTextEditingController() hook
label: "Read-only Content",
placeholder: "This content cannot be edited",
isEnabled: false,
),
```
## Properties
### Required
The controller for managing the text content of the text area.
### Content
Optional label text displayed above the text area.
Hint text displayed when the text area is empty.
Optional helper text displayed below the text area. Hidden when `errorText` is present.
Error message displayed below the text area. Takes priority over `description`.
List of input formatters to control text input behavior (e.g., length limits, character restrictions).
Hints for autofill services.
### Layout
Minimum number of lines to display.
Maximum number of lines for auto-sizing.
Maximum number of lines when manually resized. Set to null for unlimited resizing.
Whether to show the resize handle for manual height adjustment.
Double-tap the resize handle to reset to auto-sizing mode.
### Behavior
Callback triggered when the text content changes.
Callback triggered when text is submitted via keyboard shortcuts.
Callback function called when the text area loses focus. Useful for explicit blur event handling.
Controls keyboard submission behavior:
* `true`: Enter submits, Shift+Enter adds new line (chat-style)
* `false`: Cmd/Ctrl+Enter submits, Enter adds new line (editor-style)
Whether to keep focus on the text area after submission.
### State
Controls whether the text area is interactive. When disabled, the field appears dimmed and prevents all interaction.
Optional focus node for advanced focus management. If not provided, an internal focus node is created.
## Best Practices
* **Use appropriate line limits**: Set `minLines` and `maxLines` based on expected content length
* **Use chat-style submission for messaging**: Set `submitOnEnter: true` with `maintainFocusOnSubmit: true` for chat interfaces. You would also probably want to set `minLines` to `1`.