The <axa-textarea> component is a wrapper for the HTML <textarea> element with custom styling and additional functionality, e.g. a character counter.

The string-valued label provides label text for the element as HTML.

The string-valued refId sets the id attribute for the underlying native HTML <textarea>. (default: a random id value).

The string-valued name of the element can be set with this attribute.

Its intended use is for purposes of form submission.

The Boolean attribute required visualizes an element that must obligatorily be filled by the user. When true, it displays * after the label text.

String-valued placeholderspecifies the placeholder text shown when the element is empty.

The Boolean attribute invalid serves to indicate the validity of the element (default: false). If set to true, it puts the element into a visual error state.

The Boolean attribute checkMark shows an animated check mark to the right of the textarea (default: false).

Showing the check mark is suppressed when a character limit has been reached (cf. maxLength below).

The string-valued value sets the value of the underlying native HTML <textarea>.

The Boolean attribute disabled disables the underlying native HTML <textarea> text.

The Boolean readonly attribute, when present, makes the underlying native HTML <textarea> text not mutable, meaning the user can not edit the control.

The boolean attribute autocomplete put the HTML autocomplete attribute to "on". The default ist "off"

The string-valued error provides error text as HTML, to be shown when invalid is true.

The number-valued maxlength provides a maximum number of characters that the textarea allows to be entered.

To reflect this visually, a character counter is added to the element UI.

The string-valued counter takes a string template which will be used when formatting the aforementioned character counter.

A ##counter## placeholder anywhere in the string template is instantiated with the concrete character count. A missing placeholder is treated as if it were placed last in the counter string.

The string-valued countermax provides information text as HTML.

The information text is displayed instead of the character counter if the character limit defined in maxlength has been reached.

The string-valued defaultValue sets an initial (default) text in the underlying native HTML <textarea>, applied on first render of the element.

It can only be used for React.

Note: In native applications you may achieve a similar effect by making your default text a child of the element, like so: <axa-textarea>default value</axa-textarea>.

The function-valued property onChange can be used as a callback prop for React and other frameworks.

The callback is invoked whenever the underlying native HTML <textarea>'s input event fires. Its only argument is the original input event.

The function-valued property onFocus can be used as a callback prop for React and other frameworks.

The callback is invoked whenever the underlying native HTML <textarea>'s focus event fires. Its only argument is the original focus event.

The function-valued property onBlur can be used as a callback prop for React and other frameworks.

The callback is invoked whenever the underlying native HTML <textarea>'s blur event fires. Its only argument is the original blur event.

The focus() method focusses the underlying native HTML <textarea>.

Its UI consequences are the same as a keyboard/mouse-initiated focus.

The blur() method unfocusses the underlying native HTML <textarea>.

Its UI consequences are the same as a keyboard/mouse-initiated blur.