Textfield
El componente e-text-field es el input base para formularios y captura de datos estructurados en Nuvex UI. Soporta variantes visuales, iconos internos, prefijos/sufijos, comportamiento de etiqueta y estados clave como readonly, disabled y clearable.
Usa esta página para comparar patrones de interacción rápidamente, componer inputs más ricos con slots nombrados y aplicar reglas de validación que mantengan formularios claros, accionables y listos para producción.
Uso
Usa este playground base para configurar el Text Field en contexto: ajusta color, outlined, clearable, counter/limit, readonly, disabled y retain-color desde un solo panel de control.
I conos
Compara prependIcon y appendIcon con prependInnerIcon y appendInnerIcon en campos filled y outlined para elegir el peso visual correcto en contexto, acciones y escaneo.
Variantes visuales
Compara campos filled y outlined en estados interactivo, readonly y disabled, y evalúa el comportamiento de retain-color y floating-label para definir jerarquía y legibilidad en formularios reales.
Slots nombrados
Compone inputs orientados a tareas con prepend, prepend-inner, append-inner y append para incluir contexto, acciones rápidas y controles secundarios sin perder claridad.
Prefijos y sufijos
Usa prefix y suffix para fijar tokens como símbolos monetarios, IDs y unidades; así los usuarios entienden el formato esperado de inmediato y cometen menos errores de entrada.
Validación
Construye flujos de validación de extremo a extremo con reglas, visibilidad de errores y control del estado de envío. Este ejemplo usa un card de registro completo para mostrar cómo reglas de campo y disponibilidad de acciones trabajan juntas en formularios de producción.
Formulario de registro
Completa todos los campos obligatorios para continuar
Props
Usa la tabla de API como fuente de verdad para props, tipos permitidos, valores por defecto y notas de comportamiento al implementar variantes de Text Field en producción.
| Propiedad | Tipo | Por defecto |
|---|---|---|
| modelValue | string | number | null | undefined |
Valor actual del campo. Soporta uso controlado con v-model. | ||
| label | string | number | undefined |
Etiqueta del campo renderizada en el contenedor de control. | ||
| placeholder | string | undefined |
Placeholder mostrado cuando no hay valor y el comportamiento de label lo permite. | ||
| disabled | boolean | false |
Deshabilita interacciones y aplica estilos de estado deshabilitado. | ||
| readonly / inputReadonly | boolean | false |
Evita edicion manteniendo comportamiento de foco/seleccion. | ||
| clearable | boolean | false |
Muestra accion de limpiar cuando el campo tiene valor y es interactivo. | ||
| type | string | text |
Tipo nativo del input. Valores comunes: text, email y password. | ||
| limit | string | number | undefined |
Cantidad maxima de caracteres permitidos en la entrada. | ||
| counter | boolean | false |
Muestra contador de caracteres en la zona de detalles. | ||
| prefix / suffix | string | undefined |
Texto renderizado antes o despues del area de valor del input. | ||
| prependInnerIcon / appendInnerIcon | IconPath | string | undefined |
Icono mostrado dentro del marco del campo al inicio o final. | ||
| outlined | boolean | false |
Usa variante visual outlined para el contenedor del campo. | ||
| color | string | primary |
Color del tema aplicado a estados activos y acentos. | ||
| rules / detailErrors | FieldRule[] | string[] | undefined |
Reglas de validacion y mensajes de error explicitos para el estado de detalles. | ||