Config Options

Below is a list of the config options and their usages:

reRenderOnLangChange#

Applications that don't allow the user to change the language in runtime (i.e., from a dropdown), should leave it false. It can save on memory by rendering the view once and unsubscribing from the language changes event (defaults to false):

translocoConfig({
reRenderOnLangChange: boolean
})

defaultLang#

Sets the default language: (defaults to en)

translocoConfig({
defaultLang: 'en'
})

fallbackLang#

Sets the default language/s to use as a fallback. See the TranslocoFallbackStrategy section if you need to customize it:

translocoConfig({
fallbackLang: 'en',
fallbackLang: ['en', 'ru']
})

failedRetries#

How many time should Transloco retry to load translation files, in case of a load failure (defaults to 2):

translocoConfig({
failedRetries: 1
})

prodMode#

Whether the application runs in production mode: (defaults to false)
When enabled, Transloco will disable all console warnings.

import { environment } from '../environments/environment';
translocoConfig({
prodMode: environment.production
})

availableLangs#

The available languages in your application:

translocoConfig({
availableLangs: ['en', 'es']
})

missingHandler.allowEmpty#

Whether to allow empty values: (defaults to false)

translocoConfig({
missingHandler: {
allowEmpty: true
}
})

missingHandler.useFallbackTranslation#

Whether to use the fallback language for missing keys or values: (defaults to false)

translocoConfig({
fallbackLang: 'en',
missingHandler: {
// It will use the first language set in the `fallbackLang` property
useFallbackTranslation: true
}
})

missingHandler.logMissingKey#

Whether to console.warn a missing key: (defaults to true)

translocoConfig({
missingHandler: {
logMissingKey: false
}
})

flatten.aot#

Check the optimization plugin:

import { environment } from '../environments/environment';
translocoConfig({
flatten: {
aot: environment.production
}
})

interpolation#

The start and end markings for parameters: (defaults to ['{{', '}}'])

translocoConfig({
// This will enable you to specify parameters as such: `"Hello <<<value>>>"`
interpolation: ['<<<', '>>>']
})