1.0.4 • Published 4 months ago
@atmgrupomaggioli/iris-textarea v1.0.4
iris-textarea
Properties
| Property | Attribute | Description | Type | Default |
|---|---|---|---|---|
charCounter | char-counter | Contador de caracteres. | boolean | false |
cols | cols | Ancho del textarea, especificado en número de columnas. | number | undefined |
disabled | disabled | Deshabilitado. El usuario no puede interactuar. | boolean | false |
label (required) | label | Texto que se muestra como label flotante. | string | undefined |
maxlength | maxlength | Máximo número de caracteres que un usuario puede escribir. | number | 500 |
name | name | Nombre del textarea - Se usa para identificar el textarea en formularios. | string | undefined |
placeholder | placeholder | Aclara qué se debe insertar en el input. | string | '' |
readonly | readonly | Solo se puede leer el valor. El usuario no podrá interactuar, pero si enviar su valor. | boolean | false |
required | required | Indica si es requerido rellenar el textarea. | boolean | false |
resize | resize | Define cómo se puede redimensionar el textarea: 'none' (sin cambio), 'both' (ancho y alto), 'horizontal' (solo ancho), 'vertical' (solo alto) o 'auto' (ajuste automático de altura). | "auto" \| "both" \| "horizontal" \| "none" \| "vertical" | 'both' |
rows | rows | Largo del textarea, especificado en número de filas. | number | undefined |
rules | rules | Conjunto de reglas de validación para el textarea, cada una con una condición y un mensaje de error si no se cumple, permitiendo guiar al usuario en su entrada. | Rule[] | undefined |
tooltip | tooltip | Contenido del tooltip. | string \| string[] | undefined |
value | value | Texto por defecto del textarea. | string | '' |
Events
| Event | Description | Type |
|---|---|---|
blurChanged | Se emite cuando el input pierde foco. | CustomEvent<{ value: string; }> |
focusChanged | Se emite cuando el input gana foco. | CustomEvent<FocusEvent> |
inputChanged | Se emite cuando el valor del input cambia. | CustomEvent<{ value: string; }> |
Methods
clear() => Promise<void>
Limpia el valor del textarea.
Returns
Type: Promise<void>
getValue() => Promise<string>
Método público que permite obtener el valor del textarea.
Returns
Type: Promise<string>
Promesa que devuelve el valor actual del textarea.
setValue(value: string) => Promise<void>
Permite establecer el valor programáticamente.
Parameters
| Name | Type | Description |
|---|---|---|
value | string |
Returns
Type: Promise<void>
validate() => Promise<boolean>
Valida si el valor es requerido y cumple todas las reglas establecidas.
Returns
Type: Promise<boolean>
true = Válido / false = No válido.
Built with StencilJS