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

Referencia de Configuración

Todas las opciones pueden pasarse a provideNgxTranslateRoutes(config) y NgxTranslateRoutesModule.forRoot(config).

Opciones​

OpciónTipoPor defectoDescripción
enableRouteTranslatebooleantrueTraduce los segmentos del path de la URL
enableTitleTranslatebooleantrueTraduce document.title
enableQueryParamsTranslatebooleanfalseTraduce los nombres de los query params
enableLanguageInPathbooleanfalseAgrega el código de locale a la URL (/es/ruta)
includeDefaultLanguageInPathbooleanfalseIncluye el locale por defecto en la URL (/en/route)
routePrefixstring'routes'Clave raíz en el archivo de traducción para rutas
titlePrefixstring'titles'Clave raíz en el archivo de traducción para títulos
routeSuffixesWithQueryParamsobject{ route: 'root', params: 'params' }Sub-claves usadas cuando la traducción de query params está habilitada
cacheMethod'localStorage' | 'cookies''localStorage'Backend de almacenamiento
cookieExpirationDaysnumber30TTL de la cookie cuando cacheMethod es 'cookies'
cookieSameSite'Lax' | 'Strict' | 'None''Lax'Atributo SameSite de la cookie cuando cacheMethod es 'cookies'. Secure se agrega automáticamente sobre HTTPS
enableSsrRouteTranslationbooleanfalse⚠️ Eliminado en v3 — usa provideNgxTranslateRoutesSsr()
availableLanguagesstring[]['en']Idiomas para detección de URL en SSR. También se usa como fallback en browser cuando TranslateService.langs está vacío
onLanguageChange() => voidundefinedCallback al cambiar idioma y re-traducir
onError(error: unknown) => voidundefinedSe llama cuando falla la traducción de la ruta, en vez de loguear con console.error
routeTranslationStrategyFunctionundefinedFunción personalizada: (route: string) => string
routesUsingStrategystring[][]Segmentos donde aplica la función personalizada
info

languageChange$ está disponible desde v3.1.0.

Como alternativa reactiva a onLanguageChange, podés inyectar NgxTranslateRoutesService y suscribirte a languageChange$, que emite una vez que las traducciones de ruta para el nuevo idioma ya se aplicaron:

import { inject } from '@angular/core'
import { NgxTranslateRoutesService } from 'ngx-translate-routes'

const translateRoutes = inject(NgxTranslateRoutesService)
translateRoutes.languageChange$.subscribe(() => {
console.log('Idioma cambiado y rutas re-traducidas')
})

Valores por Defecto​

import { DEFAULT_CONFIG } from 'ngx-translate-routes'

Propiedades de Datos en Rutas​

PropiedadTipoDescripción
data.titlestringClave de traducción para el título
data.skipTranslationbooleanOmite traducción de título y ruta