import { EventEmitter } from '../../stencil-public-runtime'; /** * @slot label - Content to be placed as the label, will override the label prop. * @slot description - Content to be placed as the description, will override the description prop. * @slot error-description - Content to be placed as the error description, will override the errorDescription prop. */ export declare class NvFieldtextarea { el: HTMLNvFieldtextareaElement; private textareaElement; /****************************************************************************/ /** * Message defines a 'hint ' message for the Text Field. * @deprecated Use `description` instead. */ readonly message: string; /** * Add the message to the validation state. * @deprecated Use `errorDescription` and set the error prop instead. */ readonly validation: string; /****************************************************************************/ /** * Sets the ID for the input element and the for attribute of the associated * label. If no ID is provided, a random one will be automatically generated * to ensure unique identification, facilitating proper label association and * accessibility. */ readonly inputId: string; /** * Lets you define the text that explains what users should enter in the text * textarea field. It’s a crucial element for making forms clear and * user-friendly. */ readonly label: string; /** * Add helpful hints or extra information under the text textarea field. This is * where you can clarify what users should enter or provide additional * instructions, making the form easier to fill out correctly. */ description: string; /** * Display temporary text inside the textarea field to give users a hint about * what to type. It’s a great way to provide examples or suggestions directly * in the field before they start typing. */ readonly placeholder: string; /** * Defines the name attribute of the textarea field, which is crucial for form * submission. This value is used as the key in the key-value pair sent to * the server, representing the textarea’s data in form submissions. It should be * unique within the form to avoid conflicts */ readonly name: string; /** * Specifies the value of the textarea field, which determines the text displayed * within the field. This prop is typically used in controlled components * where the textarea’s value is managed by the component’s state. */ value: string; /** * The disabled prop lets you turn off the textarea field so that users can’t * type in it. When disabled, the field is grayed out and won’t respond to# * clicks or touches. */ readonly disabled: boolean; /** * Display the textarea field’s content without allowing users to change it. * Users can still click on it, select, and copy the text, but they won’t be * able to type or delete anything. */ readonly readonly: boolean; /** * Marks the textarea field as required, ensuring that the user must fill it out * before submitting the form. * @note This uses the native HTML `required` attribute, which triggers browser validation. */ readonly required: boolean; /** * Marks the textarea field as required for accessibility purposes without triggering * native HTML validation. Use this when implementing custom validation logic. * @note When set, this uses `aria-required` instead of the native `required` attribute. * This allows developers to implement custom validation while maintaining accessibility. * @note If this prop is not explicitly set, the component will check for the HTML attribute * 'aria-required' directly to determine if it should be applied. */ readonly ariaRequiredAttr: boolean; /** * Alters the textarea field's appearance to indicate an error, helping users * identify fields that need correction. * @validator error */ error: boolean; /** * Show a helpful message under the textarea field when there’s a problem. It * explains what’s wrong and how users can fix it, making the error easier to * understand and resolve. * @validator message */ errorDescription: string; /** * Changes the textarea field’s appearance to indicate successful textarea or * validation. */ readonly success: boolean; /** * Limits how many characters users can type into the textarea field. It’s * helpful for making sure users don’t enter too much information, keeping * their textarea within the allowed limit. */ readonly maxlength: number; /** * Ensures that users type at least a certain number of characters into the * textarea field. It’s a way to make sure users provide enough information * before moving on. */ readonly minlength: number; /** * The number of visible text lines for the control. The default is 3. This * can be useful when you want to limit the size of the textarea field or when * you want to make the textarea field smaller to fit a specific layout. The * textarea field will expand vertically to fit the text as the user types. */ readonly rows: number; /** * Controls the resize property of a textarea. It can be set to none, both, * horizontal, or vertical. The default is vertical. */ readonly resize: 'none' | 'both' | 'horizontal' | 'vertical'; /** * Enable this to make the textarea automatically resize as the user types, * adjusting the height to fit the content. For the best experience, avoid * vertical resizing, as it's controlled by this feature. Horizontal resizing * can still be allowed if desired. */ readonly autosize: boolean; /** * Sets a maximum height (in pixels) for the textarea when autosize is * enabled. Once the content exceeds this height the textarea will stop * growing and the content will overflow with a scrollbar. This is useful * for chat-style inputs where unlimited growth is undesirable. Only * applies when `autosize` is `true`. */ readonly maxAutoHeight: number; /** * Applies focus to the input field as soon as the component is mounted. This * is equivalent to setting the native autofocus attribute on a