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'attributi18npar 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
i18net$localize, et génère un fichier de traduction source (messages.xlfpar défaut).- Message ICU
Syntaxe
{expression, plural, ...}ou{expression, select, ...}utilisée dans un texte marquéi18npour 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.localesest configuré : un dossier de sortie distinct par langue, contenant une application déjà traduite (aucune traduction n'a lieu au chargement).
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.