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.

primary

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.

7 / 12

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.

PropiedadTipoPor defecto
modelValuestring | number | nullundefined

Valor actual del campo. Soporta uso controlado con v-model.

labelstring | numberundefined

Etiqueta del campo renderizada en el contenedor de control.

placeholderstringundefined

Placeholder mostrado cuando no hay valor y el comportamiento de label lo permite.

disabledbooleanfalse

Deshabilita interacciones y aplica estilos de estado deshabilitado.

readonly / inputReadonlybooleanfalse

Evita edicion manteniendo comportamiento de foco/seleccion.

clearablebooleanfalse

Muestra accion de limpiar cuando el campo tiene valor y es interactivo.

typestringtext

Tipo nativo del input. Valores comunes: text, email y password.

limitstring | numberundefined

Cantidad maxima de caracteres permitidos en la entrada.

counterbooleanfalse

Muestra contador de caracteres en la zona de detalles.

prefix / suffixstringundefined

Texto renderizado antes o despues del area de valor del input.

prependInnerIcon / appendInnerIconIconPath | stringundefined

Icono mostrado dentro del marco del campo al inicio o final.

outlinedbooleanfalse

Usa variante visual outlined para el contenedor del campo.

colorstringprimary

Color del tema aplicado a estados activos y acentos.

rules / detailErrorsFieldRule[] | string[]undefined

Reglas de validacion y mensajes de error explicitos para el estado de detalles.