Saltar al contenido principal
Version: 2.x

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 Universal / @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 y NgModule — funciona con ambos estilos de aplicación

Ejemplos en Vivo

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

ngx-translate-routesAngular
2.4.x16.x – 21.x
2.3.x16.x – 21.x
2.0.x – 2.2.x16.x – 19.x
1.4.013.x – 15.x
1.3.08.x – 12.x