Form Components
textarea-component
Overview
textarea-component
allows users to enter multiline text.
It is ideal for larger inputs like comments or messages in a form.
This component is used in the scheduling form to input multiline text.
Version | 1.1.4 |
Install (React) | npm install @nylas/react |
Import (React) | import { TextareaComponent } from '@nylas/react'; |
Import (CDN) | <script type="module">
import { defineCustomElement } from "https://cdn.jsdelivr.net/npm/@nylas/web-elements@latest/dist/cdn/textarea-component/textarea-component.es.js";
defineCustomElement();
</script> |
Properties
Property | Attribute | Description | Type | Default |
---|---|---|---|---|
autoFocus | Automatically focus the textarea when the component loads. | boolean | false | |
defaultValue | The default value of the textarea, appearing when the component first renders. | string | undefined | undefined | |
label | The label for the textarea, displayed above it. | string | '' | |
maxLength | The maximum number of characters allowed in the textarea. | number | 255 | |
name | The name of the textarea, important for form submissions. | string | 'textarea' | |
placeholder | Placeholder text shown in the textarea when it is empty. | string | '' | |
readOnly | If true, the textarea cannot be edited by the user. | boolean | false | |
required | Specifies if the textarea is required for form submission. If true, an error message shows if left empty. | boolean | false | |
tooltip | The content of the label’s tooltip | string | '' | |
type | The type | string | 'multi_line_text' |
Events
Event | Description | Type |
---|---|---|
nylasFormInputChanged | Event emitted when the value of the textarea changes. Useful for parent components to capture user input. | CustomEvent<{ value: string; name: string; error: string; label: string; type: string; }> |
Shadow Parts
Part | Description |
---|---|
"tc__label" | The label for the textarea. |
"tc__textarea" | The textarea element. |
Built with StencilJS