Skip to main content

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 { isDevMode } from '@angular/core';

translocoConfig({
  prodMode: !isDevMode()
})

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 {isDevMode} from "@angular/core";

translocoConfig({
  flatten: {
    aot: !isDevMode()
  }
})

interpolation​

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

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