Saltar al contenido principal
Version: 3.x (más reciente)

NgxTranslateRoutes

CI npm version

NgxTranslateRoutes es una librería para Angular que traduce automáticamente las rutas de URL y los títulos de página usando @ngx-translate/core.

Características​

  • ✅ Traducción de rutas — reemplaza los segmentos de URL con sus traducciones
  • ✅ Traducción de títulos — actualiza document.title desde tus archivos de traducción
  • ✅ Idioma en la URL — agrega el locale activo a las URLs (/es/mi-ruta)
  • ✅ Soporte SSR — compatible con @angular/ssr
  • ✅ Traducción de query params — traduce los nombres de parámetros de consulta
  • ✅ Estrategias personalizadas — sobreescribe la lógica de traducción por ruta
  • ✅ Múltiples estrategias de caché — localStorage o cookies
  • ✅ Standalone — soporte de primera clase; la API NgModule está deprecada en v3

Ejemplos en Vivo​

Probá la librería acá mismo - es la misma app de showcase que vive en el repo:

También podés abrir estos ejemplos listos para usar:

EjemploEnlace
Aplicación Standalone con SSRAbrir en Stackblitz
Aplicación con NgModuleAbrir en Stackblitz

Cómo Funciona​

La librería se conecta a los eventos del router de Angular. En cada NavigationEnd, lee el data.title de la ruta activa y los segmentos del path, los busca en tus archivos de traducción de @ngx-translate, y actualiza tanto la URL como el título del documento — sin disparar una nueva navegación.

El usuario navega a /about
└─▶ NavigationEnd se dispara
└─▶ NgxTranslateRoutes lee data.title = 'about'
├─▶ Traduce el título → 'Sobre Nosotros' (document.title)
└─▶ Traduce la ruta → '/sobreNosotros' (location.replaceState)

Compatibilidad​

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

ngx-translate-routesAngular
3.1.118.x a 22.x
3.1.018.x a 22.x
3.0.018.x a 22.x
2.4.016.x a 21.x
2.3.616.x a 21.x
2.3.516.x a 21.x
2.3.416.x a 21.x
2.3.316.x a 21.x
2.3.216.x a 19.x
2.3.116.x a 19.x
2.3.016.x a 19.x
2.2.116.x a 19.x
2.2.016.x a 19.x
2.1.416.x a 18.x
2.1.316.x a 18.x
2.1.216.x a 18.x
2.1.116.x a 18.x
2.1.016.x a 18.x
2.0.116.x a 18.x
2.0.016.x a 18.x
1.4.013.x a 15.x
1.3.08.x a 12.x
1.2.09.x 8.x 7.x
1.1.09.x 8.x 7.x
1.0.29.x 8.x 7.x
1.0.09.x 8.x 7.x
0.1.09.x 8.x 7.x