Skip to content

SiTranslatePipe Type documentation

implements PipeTransform, OnDestroy
Translates keys by using the SiTranslateService . Within Element this pipe should be used instead of ngx-translates translate pipe. Outside Element, this pipe should NOT be used.
Constructor
() => {}
Properties
cdRef: any
lastKeyParams?: any
siTranslateService: any
subscription?: any
updateValue: any
value: any
ɵfac: unknown
ɵpipe: unknown
Methods
A callback method that performs custom clean-up, invoked immediately before a directive, pipe, or service instance is destroyed.
ngOnDestroy: () => void from OnDestroy.ngOnDestroy
(key: string, params: any) => string from PipeTransform.transform
Method which is called on any data passed to the pipe. Called by Angular, should not be called directly.
Parameters
key: string
params?: any
(key: (undefined | null | string), params: any) => (undefined | null | string) from PipeTransform.transform
Method which is called on any data passed to the pipe. Called by Angular, should not be called directly.
Parameters
key: (undefined | null | string)
params?: any

Types Documentation

Wrapper around an actual translation framework which is meant to be used internally by Element. Applications must not use this service.

Use injectSiTranslateService to get an instance of the translation service.
Constructor
() => {}
Properties
documentRef: any
prevent$LocalizeInit?: boolean
translationChange$: Observable<void>
ɵfac: unknown
ɵprov: ɵɵInjectableDeclaration<SiTranslateService>
Accessors
The available languages.
get availableLanguages: string[]
set availableLanguages: (languages: string[])
The currently used language.
get currentLanguage: string
If the underlying translation library supports switching the language and/or updating the translation texts, this observable will emit. There is no initial emit.
get translationChange: Observable<void>
Methods
The language to be used as default.
Returns The code of the default language.
getDefaultLanguage: () => string
(lang: string) => Observable<void>
Sets a new language to be used. If needed, loads the language file.
Returns An observable that emits when the new language is loaded and activated.
Parameters
The language to be used.
lang: string
(lang: string) => void
The language to be used as default.
Parameters
The language code.
lang: string
(lang: string) => void
Parameters
lang: string
(key: string, value: string) => void
If supported by the underlying translation library, this method can be used to add a translation for a specific key.
It is intended to be used for adding the english default value.
It will be called whenever a key within element is resolved.
An implementation of this method must check that it does not override an existing translation.
Parameters
key: string
value: string
<(T: (string | string[]))> (keys: T, params: Record<string, unknown>) => (TranslationResult<T> | Observable<TranslationResult<T>>)
Translates the key(s) by using the underlying translation library.
Returns Returns the translated key or an object with the translated keys. Depending on the underlying translation library (sync/async) the result will be wrapped in an Observable.
Parameters
A single translation key or an array of keys.
keys: T
Parameters to be replaced within the translation text.
params?: Record<string, unknown>
<(T: (string | string[]))> (keys: T, params: Record<string, unknown>) => Observable<TranslationResult<T>>
Translates the key(s) by using the underlying translation library in an asynchronous manner. It will emit each time the active language is changed.
Returns Returns the translated key or an object with the translated keys wrapped in an Observable.
Parameters
A single translation key or an array of keys.
keys: T
Parameters to be replaced within the translation text.
params?: Record<string, unknown>
<(T: (string | string[]))> (keys: T, params: Record<string, unknown>) => TranslationResult<T>
Translates the key(s) by using the underlying translation library in a synchronous manner.

Warning: The caller of this function needs to make sure the translation file(s) are already loaded. It is generally not recommended to use this function unless you know exactly what you are doing.

Returns Returns the translated key or an object with the translated keys.
Parameters
A single translation key or an array of keys.
keys: T
Parameters to be replaced within the translation text.
params?: Record<string, unknown>
() => SiTranslateService
Function

<T> T extends string ? string : Record<string, string>

Except where otherwise noted, content on this site is licensed under MIT License.