Saltar al contenido principal
Version: 3.x

NgxErrorMessage

CI Quality Gate Status Coverage

NgxErrorMessage es una librería de Angular que muestra automáticamente mensajes de error de validación para formularios reactivos y template-driven, con soporte opcional de @ngx-translate.

Características​

  • ✅ Visualización automática de errores — agregá una directiva a un input y obtené su mensaje de error gratis
  • ✅ Formularios reactivos y template-driven — la misma directiva funciona para ambos
  • ✅ Internacionalización — integración opcional con @ngx-translate/core
  • ✅ Estilos personalizables — sobrescribí las clases CSS usadas para el contenedor y el mensaje de error
  • ✅ Visualización condicional — controlá exactamente cuándo se debe mostrar un error (touched, dirty, invalid, ...)
  • ✅ Patrones incorporados y personalizados — un conjunto de patrones regex listos para usar, más soporte para los tuyos
  • ✅ Standalone-first — provideNgxErrorMessage() para apps standalone; NgxErrorMessageModule para apps con NgModule

Ejemplo en Vivo​

Podés ver la librería en acción acá: ngx-error-message-example.

Cómo Funciona​

Agregá la directiva ngxErrorMessage a un control de formulario. Cuando el control se vuelve inválido (y coincide con la condición de visualización configurada), la directiva renderiza el mensaje de su primer error activo, resuelto desde un objeto de configuración estático o desde tus archivos de traducción de @ngx-translate.

<input formControlName="email" ngxErrorMessage />
└─▶ el control se vuelve inválido + touched
└─▶ NgxErrorMessage lee control.errors
└─▶ resuelve el mensaje del primer error
└─▶ lo renderiza junto al input

Compatibilidad​

Última versión disponible para cada versión de Angular:

ngx-error-messageAngular
3.1.016.x a 19.x
3.0.116.x a 19.x
3.0.016.x a 19.x
2.2.110.x a 14.x
2.2.010.x a 14.x
2.1.09.x a 13.x
2.0.18.x a 11.x
2.0.08.x a 11.x
1.3.09.x 8.x 7.x