Persist Lang
This plugin provides the functionality of persisting the active language to the provided storage.
Installation
npm install @jsverse/transloco-persist-lang
Usage
Add persist lang providers using the into the TranslocoRootModule
/app.config.ts
, and provide the storage you would like to use:
transloco-root.module.ts
import { provideTranslocoPersistLang } from '@jsverse/transloco-persist-lang';
@NgModule({
providers: [
provideTranslocoPersistLang({
storage: {
useValue: localStorage,
},
}),
],
...
})
export class TranslocoRootModule {}
When the user changes the current language, the plugin will keep it in the provided storage and set it as active when the user returns to the application.
By default, the plugin will use the cached language if available otherwise it will use the default language provided in the config. You can always change this behavior by providing a getLangFn
option:
transloco-root.module.ts
import { provideTranslocoPersistLang } from '@jsverse/transloco-persist-lang';
export function getLangFn({
cachedLang,
browserLang,
cultureLang,
defaultLang,
}) {
return yourLogic;
}
@NgModule({
providers: [
provideTranslocoPersistLang({
getLangFn,
storage: {
useValue: localStorage,
},
}),
],
...
})
export class TranslocoRootModule {}
The plugin also provides a cookiesStorage
function that you can use to save the language in a cookie. (SSR advantage)
transloco-root.module.ts
import { provideTranslocoPersistLang, cookiesStorage } from '@jsverse/transloco-persist-lang';
@NgModule({
imports: [
provideTranslocoPersistLang({
storage: {
useValue: cookiesStorage(),
},
}),
],
...
})
export class TranslocoRootModule {}