Formations — 1 037 leçons en français

Accueil › Angular › Traduire une application avec l'i18n d'Angular

Traduire une application avec l'i18n d'Angular

Internationalisation et accessibilitéintermediaire

L'i18n officielle d'Angular repose sur le package @angular/localize et une idée simple : le texte est marqué dans le code source, extrait par un outil, traduit dans des fichiers séparés, puis remplacé au moment du build — une fois par langue.

Dans un template, l'attribut i18n marque un élément comme traduisible :

<h1 i18n>Bienvenue dans la boutique</h1>
<img [src]="logo" i18n-alt alt="Logo de la boutique" />

En TypeScript, $localize marque une chaîne construite dynamiquement :

const message = $localize`Commande n° ${numero}:numero: confirmée`;

La commande ng extract-i18n parcourt le projet et génère un fichier source des messages à traduire (messages.xlf par défaut). Une fois les traductions fournies (une par locale, dans un fichier séparé), on configure angular.json :

"i18n": {
  "sourceLocale": "fr",
  "locales": {
    "en": { "translation": "src/locale/messages.en.xlf" }
  }
}

Un ng build avec localize activé produit alors un dossier par locale, chacun contenant une application déjà traduite — sans traduction faite dans le navigateur.

Les termes à connaître

@angular/localize

Package officiel qui fournit l'infrastructure d'internationalisation d'Angular : la fonction $localize, la prise en charge de l'attribut i18n par le compilateur, et les outils d'extraction/fusion des traductions.

i18n

Attribut de template qui marque un élément comme traduisible. Angular l'utilise à la fois pour extraire le texte source et pour injecter la bonne traduction au build.

$localize

Fonction tagged template utilisée en TypeScript pour marquer une chaîne comme traduisible, en dehors d'un template HTML (messages construits dynamiquement, notifications, Validators).

ng extract-i18n

Commande CLI qui parcourt les templates et le code source à la recherche des marqueurs i18n et $localize, et génère un fichier de traduction source (messages.xlf par défaut).

Message ICU

Syntaxe {expression, plural, ...} ou {expression, select, ...} utilisée dans un texte marqué i18n pour gérer le pluriel ou choisir un texte selon la valeur d'une variable (genre, statut…).

Locale

Identifiant d'une langue et d'une région (ex. fr, fr-CA, en-US) utilisé par Angular pour choisir la traduction, le format des nombres/dates, et générer un build dédié.

Build par locale

Résultat de la compilation Angular quand i18n.locales est configuré : un dossier de sortie distinct par langue, contenant une application déjà traduite (aucune traduction n'a lieu au chargement).

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.