TranslateService API

This content is for v15. Switch to the latest version for up-to-date documentation.

Methods

setDefaultLang

setDefaultLang(lang: string)

Sets the default language to use as a fallback. A translation is used from the default language, if no translation is found in the current language.

Calling setDefaultLang() uses the loader to retrieve the language and updates the list of available languages which can be retrieved using getLangs().

use

use(lang: string): Observable<any>

Changes the currently active language. This method triggers the loader to retrieve the translations if the language has not been loaded yet.

Calling use() fetches the translation for the given language and updates the list of available languages, which can be accessed using getLangs().

getTranslation

getTranslation(lang: string): Observable<any>

Gets an object of translations for a given language with the current loader.

setTranslation

setTranslation(lang: string, translations: Object, shouldMerge: boolean = false)

Manually sets an object of translations for a given language, set shouldMerge to true if you want to append the translations instead of replacing them.

Using setTranslation updates the list of available languages which can be retrieved using getLangs.

addLangs

addLangs(langs: Array<string>)

Add new languages to the list. This does not invoke the loader to retrieve the languages.

getLangs

getLangs(): string

Returns an array of currently available languages. The list can be extended calling setDefaultLang, use, setTranslation oraddLangs.

get

get(key: string|Array<string>, interpolateParams?: Object): Observable<string|Object>

Retrieves the translated value for a key (or an array of keys). If the translation is not found, the key itself is returned. The Observable will emit once the language file has finished loading.

If you also want to receive updates when the language changes, consider using stream() instead.

getStreamOnTranslationChange

getStreamOnTranslationChange(key: string|Array<string>, interpolateParams?: Object): Observable<string|Object>

Returns a stream of translated values for a key (or an array of keys). If the translation is not found, the key itself is returned. Without any onTranslationChange() events, this behaves similarly to get(). However, it will also emit new values whenever the translation changes.

stream

stream(key: string|Array<string>, interpolateParams?: Object): Observable<string|Object>

Returns a stream of translated values for a key (or an array of keys). If the translation is not found, the key itself is returned. Without any onLangChange() events, this behaves the same as get(), but it will also emit new values whenever the active language changes.

instant

instant(key: string|Array<string>, interpolateParams?: Object): string|Object

Retrieves the translated value for a key (or an array of keys) instantly.

set

set(key: string, value: string, lang?: string)

Assigns a translated value to a specific key. Optionally, you can specify a language to set the translation for. If no language is provided, it defaults to the currently active language.

reloadLang

reloadLang(lang: string): Observable<string|Object>

This method calls resetLang() and re-fetches the translations object using the current loader for the specified language.

resetLang

resetLang(lang: string)

Removes the current translations for the specified language.

getBrowserLang

getBrowserLang(): string | undefined

Returns the browser’s current language setting if available, or undefined if it cannot be determined.

getBrowserCultureLang

getBrowserCultureLang(): string | undefined

Returns the browser’s full culture language code (e.g., "en-US") if available, or undefined if it cannot be determined.

Properties

The TranslateService exposes the following properties:

Properties

The TranslateService exposes the following properties:

Property	Description
`langs`	List of languages. `string[]`
`translations`	Object containing translations per language `any`
`currentLang`	The language currently in use. `string`
`defaultLang`	The default (fallback) language. `string`
`currentLoader`	The current instance of the loader (static loader by default). `TranslateLoader`
`onLangChange`	Event emitter that fires when the language changes. `EventEmitter<LangChangeEvent>`
`onTranslationChange`	Event emitter that fires when the translations change. `EventEmitter<TranslationChangeEvent>`
`onDefaultLangChange`	Event emitter that fires when the default language changes. `EventEmitter<DefaultLangChangeEvent>`

Event Emitters

onLangChange (Event Emitter)

An EventEmitter that listens for language change events. A LangChangeEvent object is emitted, containing the following properties:

Name	Type	Description
`lang`	`string`	The code of the newly activated language.
`translations`	`any`	An object containing the updated translations.

Example:

onLangChange.subscribe((event: LangChangeEvent) => {
    // do something
);

onTranslationChange (Event Emitter)

An EventEmitter that listens for translation change events.

A TranslationChangeEvent object is emitted, containing the following properties:

Name	Type	Description
`lang`	`string`	The code of the currently active language.
`translations`	`any`	An object containing the updated translations.

Example:

onTranslationChange.subscribe((event: TranslationChangeEvent) => {
    // do something
);

onDefaultLangChange (Event Emitter)

An EventEmitter that listens for default language change events.

A DefaultLangChangeEvent object is emitted, containing the following properties:

Name	Type	Description
`lang`	`string`	The code of the newly set default language.
`translations`	`any`	An object containing the default translations.

Example:

onDefaultLangChange.subscribe((event: DefaultLangChangeEvent) => {
  // Do something with the new default language or translations
});