Traduisez votre site web Angular 19 (Webpack) avec Intlayer | Internationalisation (i18n)

Table des matières

Pourquoi Intlayer plutôt que des alternatives ?

Par rapport aux solutions principales telles que ngx-translate ou angular-l10n, Intlayer est une solution dotée d'optimisations intégrées telles que :

Guide étape par étape pour configurer Intlayer dans une application Angular

Voir le Modèle d'application sur GitHub.

1. 1

   Installer les dépendances

   Installez les packages nécessaires en utilisant npm :

   bash

   Copier le contenu

   Copier le code

   Copier le code dans le presse-papiers

   npm install intlayer angular-intlayernpm install @angular-builders/custom-webpack --save-devnpx intlayer init

   • intlayer

     Le package principal qui fournit des outils d'internationalisation pour la gestion de la configuration, la traduction, la déclaration de contenu, la transpilation et les commandes CLI.

   • angular-intlayer Le package qui intègre Intlayer à l'application Angular. Il fournit des fournisseurs de contexte et des hooks pour l'internationalisation Angular.

   • @angular-builders/custom-webpack Requis pour personnaliser la configuration Webpack de l'Angular CLI.

2. 2

   Configuration de votre projet

   Créez un fichier de configuration pour configurer les langues de votre application :

   intlayer.config.ts

   Copier le contenu

   Copier le code

   Copier le code dans le presse-papiers

   import { Locales, type IntlayerConfig } from "intlayer";
   
   const config: IntlayerConfig = {
     internationalization: {
       locales: [
         Locales.ENGLISH,
         Locales.FRENCH,
         Locales.SPANISH,
         // Vos autres locales
       ],
       defaultLocale: Locales.ENGLISH,
     },
   };
   
   export default config;

   Grâce à ce fichier de configuration, vous pouvez configurer les URL localisées, la redirection middleware, les noms de cookies, l'emplacement et l'extension de vos déclarations de contenu, désactiver les logs Intlayer dans la console, et plus encore. Pour une liste complète des paramètres disponibles, reportez-vous à la documentation de configuration.

3. 3

   Intégrer Intlayer dans votre configuration Angular

   Pour intégrer Intlayer avec l'Angular CLI, vous devez utiliser un builder personnalisé. Ce guide suppose que vous utilisez Webpack (par défaut pour de nombreux projets Angular).

   Tout d'abord, modifiez votre angular.json pour utiliser le builder Webpack personnalisé. Mettez à jour les configurations build et serve :

   angular.json

   Copier le contenu

   Copier le code

   Copier le code dans le presse-papiers

   {  "projects": {    "votre-nom-d-application": {      "architect": {        "build": {          "builder": "@angular-builders/custom-webpack:browser", // replace "@angular-devkit/build-angular:application",          "options": {            "customWebpackConfig": {              "path": "./webpack.config.ts",              "mergeStrategies": { "module.rules": "prepend" },            },            "main": "src/main.ts", // replace "browser": "src/main.ts",            // ...          },        },      },    },  },}

   Assurez-vous de remplacer votre-nom-d-application par le nom réel de votre projet dans angular.json.

   Ensuite, créez un fichier webpack.config.ts à la racine de votre projet :

   webpack.config.ts

   Copier le contenu

   Copier le code

   Copier le code dans le presse-papiers

   import { mergeConfig } from "angular-intlayer/webpack";export default mergeConfig({});

   La fonction mergeConfig configure Webpack avec Intlayer. Elle injecte le IntlayerPlugin (pour gérer les fichiers de déclaration de contenu) et configure des alias pour des performances optimales.

4. 4

   Déclarer votre contenu

   Créez et gérez vos déclarations de contenu pour stocker les traductions :

   Vos déclarations de contenu peuvent être définies n'importe où dans votre application tant qu'elles sont incluses dans le répertoire contentDir (par défaut, ./src) et qu'elles correspondent à l'extension de fichier de déclaration de contenu (par défaut, .content.{json,ts,tsx,js,jsx,mjs,cjs,md,mdx,yaml,yml}).

   Pour plus de détails, reportez-vous à la documentation de déclaration de contenu.

5. 5

   Utiliser Intlayer dans votre code

   Pour utiliser les fonctionnalités d'internationalisation d'Intlayer dans toute votre application Angular, vous devez fournir Intlayer dans la configuration de votre application.

   src/app/app.config.ts

   Copier le contenu

   Copier le code

   Copier le code dans le presse-papiers

   import { ApplicationConfig } from "@angular/core";import { provideRouter } from "@angular/router";import { provideIntlayer } from "angular-intlayer";import { routes } from "./app.routes";export const appConfig: ApplicationConfig = {  providers: [    provideRouter(routes),    provideIntlayer(), // Ajoutez le fournisseur Intlayer ici  ],};

   Ensuite, vous pouvez utiliser la fonction useIntlayer dans n'importe quel composant.

   src/app/app.component.ts

   Copier le contenu

   Copier le code

   Copier le code dans le presse-papiers

   import { Component } from "@angular/core";import { RouterOutlet } from "@angular/router";import { useIntlayer } from "angular-intlayer";@Component({  selector: "app-root",  standalone: true,  imports: [RouterOutlet],  templateUrl: "./app.component.html",  styleUrl: "./app.component.css",})export class AppComponent {  content = useIntlayer("app");}

   Et dans votre template :

   src/app/app.component.html

   Copier le contenu

   Copier le code

   Copier le code dans le presse-papiers

   <div class="content">  <h1>{{ content().title }}</h1>  <p>{{ content().congratulations }}</p></div>

   Le contenu Intlayer est retourné sous forme de Signal, vous accédez donc aux valeurs en appelant le signal : content().title.

6. 6

   Changer la langue de votre contenu

   Facultatif

   Pour changer la langue de votre contenu, vous pouvez utiliser la fonction setLocale fournie par la fonction useLocale. Cela vous permet de définir la locale de l'application et de mettre à jour le contenu en conséquence.

   Créez un composant pour basculer entre les langues :

   src/app/locale-switcher.component.ts

   Copier le contenu

   Copier le code

   Copier le code dans le presse-papiers

   import { Component } from "@angular/core";import { CommonModule } from "@angular/common";import { useLocale } from "angular-intlayer";@Component({  selector: "app-locale-switcher",  standalone: true,  imports: [CommonModule],  template: `    <div class="locale-switcher">      <select        [value]="locale()"        (change)="setLocale($any($event.target).value)"      >        @for (loc of availableLocales; track loc) {          <option [value]="loc">{{ loc }}</option>        }      </select>    </div>  `,})export class LocaleSwitcherComponent {  localeCtx = useLocale();  locale = this.localeCtx.locale;  availableLocales = this.localeCtx.availableLocales;  setLocale = this.localeCtx.setLocale;}

   Ensuite, utilisez ce composant dans votre app.component.ts :

   src/app/app.component.ts

   Copier le contenu

   Copier le code

   Copier le code dans le presse-papiers

   import { Component } from "@angular/core";import { RouterOutlet } from "@angular/router";import { useIntlayer } from "angular-intlayer";import { LocaleSwitcherComponent } from "./locale-switcher.component";@Component({  selector: "app-root",  standalone: true,  imports: [RouterOutlet, LocaleSwitcherComponent],  templateUrl: "./app.component.html",  styleUrl: "./app.component.css",})export class AppComponent {  content = useIntlayer("app");}

Configurer TypeScript

Intlayer utilise l'augmentation de module pour tirer parti de TypeScript et renforcer votre codebase.

Assurez-vous que votre configuration TypeScript inclut les types autogénérés.

{  // ... Vos configurations TypeScript existantes  "include": [    // ... Vos configurations TypeScript existantes    ".intlayer/**/*.ts", // Inclure les types auto-générés  ],}

Configuration Git

Il est recommandé d'ignorer les fichiers générés par Intlayer. Cela vous évite de les commiter dans votre dépôt Git.

Pour ce faire, vous pouvez ajouter les instructions suivantes à votre fichier .gitignore :

#  Ignorer les fichiers générés par Intlayer.intlayer

Extension VS Code

Pour améliorer votre expérience de développement avec Intlayer, vous pouvez installer l'extension officielle Intlayer VS Code Extension.

Installer depuis le VS Code Marketplace

Cette extension fournit :

• L'autocomplétion pour les clés de traduction.
• La détection d'erreurs en temps réel pour les traductions manquantes.
• Des prévisualisations en ligne du contenu traduit.
• Des actions rapides pour créer et mettre à jour facilement les traductions.

Pour plus de détails sur l'utilisation de l'extension, reportez-vous à la documentation de l'extension Intlayer VS Code.

Aller plus loin

Pour aller plus loin, vous pouvez implémenter l'éditeur visuel ou externaliser votre contenu en utilisant le CMS.