sábado 4 enero 2025

Cómo Configurar el Multidioma en Angular con ngx-translate

Configurar una aplicación Angular para soportar múltiples idiomas es clave para alcanzar un público global. Con la biblioteca ngx-translate, puedes implementar traducciones de manera sencilla y eficiente. A continuación, se detalla cómo configurarla paso a paso.

¿Qué es ngx-translate?

ngx-translate es una poderosa biblioteca para manejar la internacionalización (i18n) en aplicaciones Angular. Permite cargar archivos de traducción dinámicamente, cambiar idiomas en tiempo de ejecución y gestionar claves de traducción de forma organizada.

Pasos para Configurar ngx-translate en Angular

1. Instalación de ngx-translate

Primero, instala las dependencias necesarias:

npm install @ngx-translate/core @ngx-translate/http-loader --save

2. Configurar el módulo principal

Importa y configura ngx-translate en el archivo app.module.ts:

import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { AppComponent } from './app.component';
import { HttpClientModule } from '@angular/common/http';
import { TranslateModule, TranslateLoader } from '@ngx-translate/core';
import { TranslateHttpLoader } from '@ngx-translate/http-loader';
import { HttpClient } from '@angular/common/http';

// Función de carga para ngx-translate
export function HttpLoaderFactory(http: HttpClient) {
  return new TranslateHttpLoader(http);
}

@NgModule({
  declarations: [AppComponent],
  imports: [
    BrowserModule,
    HttpClientModule,
    TranslateModule.forRoot({
      loader: {
        provide: TranslateLoader,
        useFactory: HttpLoaderFactory,
        deps: [HttpClient]
      }
    })
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

3. Crear archivos de traducción

Crea un directorio para los archivos de traducción, por ejemplo, assets/i18n/, y dentro, agrega archivos JSON para cada idioma:

assets/i18n/es.json (Español):

{
  "GREETING": "Hola, mundo"
}

assets/i18n/en.json (Inglés):

{
  "GREETING": "Hello, world"
}

4. Utilizar ngx-translate en los componentes

Inyecta el servicio de traducción en el componente y utiliza las claves de traducción:

import { Component } from '@angular/core';
import { TranslateService } from '@ngx-translate/core';

@Component({
  selector: 'app-root',
  template: `
    <h1>{{ 'GREETING' | translate }}</h1>
    <button (click)="changeLanguage('es')">Español</button>
    <button (click)="changeLanguage('en')">English</button>
  `
})
export class AppComponent {
  constructor(private translate: TranslateService) {
    translate.setDefaultLang('en');
  }

  changeLanguage(lang: string) {
    this.translate.use(lang);
  }
}

Algunos ejemplos prácticos

1. Cambiar idioma dinámicamente:

this.translate.use('fr'); // Cambia al francés

2. Uso en servicios:

this.translate.get('GREETING').subscribe((res: string) => {
     console.log(res); // Traducción de "GREETING"
   });

3. Interpolación de variables:

{
     "WELCOME_MESSAGE": "Hola, {{name}}"
   }

Uso en el template:

{{ 'WELCOME_MESSAGE' | translate:{ name: 'Juan' } }}

Referencia oficial

Para más información, visita la documentación oficial de ngx-translate:

https://github.com/ngx-translate/core

Etiquetas:

typescript angular

Creado por:

Jorge García

Fullstack developer