💡 Pour localiser une application Angular en vietnamien : installez
@angular/localize, marquez les chaînes de template avec l'attributi18n, exécutezng extract-i18npour générer un fichier XLIFFmessages.xlf, traduisez-le en vietnamien, déclarez la localevidansangular.jsonet compilez avecng build --localize. Simplification clé : le vietnamien n'a qu'une seule catégorie de pluriel ICU, donc les chaînes plurielles n'ont besoin que d'une seule brancheother.
À retenir
- Le pipeline i18n intégré d'Angular utilise la compilation AOT : les chaînes marquées avec
i18nsont remplacées lors de la compilation, produisant un build spécifique à chaque locale sans overhead à l'exécution. - Exécutez
ng extract-i18n --output-path src/localepour générermessages.xlf, copiez-le enmessages.vi.xlfet renseignez les éléments<target>en vietnamien. - Le vietnamien n'a qu'une catégorie CLDR de pluriel : other. Votre XLIFF vietnamien n'a jamais besoin d'une branche
one. Utilisez les sélecteurs exacts=0et=1uniquement pour des cas limites spécifiques. - Enregistrez les données de locale avec
registerLocaleData(localeVi)et fournissezLOCALE_ID: 'vi'. Les pipesDatePipe,CurrencyPipeetDecimalPiped'Angular formatent alors automatiquement le VND, les dates DD/MM/YYYY et les milliers séparés par des points. - Les chaînes d'interface vietnamiennes sont 10-20% plus longues que l'anglais. Testez tous les libellés de boutons, onglets de navigation et viewports mobiles avant la première version.
Comment fonctionne le système i18n intégré d'Angular ?
Angular fournit un pipeline d'internationalisation complet dans le package @angular/localize. Contrairement aux bibliothèques i18n qui substituent les chaînes dans le navigateur à l'exécution, Angular compile un build distinct pour chaque locale. L'Angular CLI extrait les chaînes marquées dans un fichier XLIFF, fusionne les XLIFF traduits lors de la compilation, et génère un répertoire spécifique à chaque langue.
Le résultat est un déploiement purement statique : chaque build de locale contient exactement les chaînes dont il a besoin, sans logique de changement de locale à l'exécution. Pour une équipe française ciblant le marché vietnamien, le sous-répertoire vi/ peut être servi depuis un CDN ou un hébergeur statique sans détection de langue côté serveur.
Le guide Angular i18n officiel couvre l'intégralité du pipeline, de la configuration au déploiement.
Extraire votre fichier XLIFF et rédiger la traduction vietnamienne
Ajoutez le package localize à votre projet :
ng add @angular/localize
Marquez les chaînes dans les templates avec l'attribut i18n. Fournissez des métadonnées de sens et de description pour aider les traducteurs :
<h1 i18n="site title|Homepage heading">My Product</h1>
<img i18n-title title="Company logo" alt="Company logo" />
Extrayez toutes les chaînes marquées :
ng extract-i18n --output-path src/locale
Cela crée src/locale/messages.xlf. Copiez-le en src/locale/messages.vi.xlf et ajoutez les éléments <target> en vietnamien :
<trans-unit id="introductionHeader" datatype="html">
<source>My Product</source>
<target>Sản phẩm của tôi</target>
</trans-unit>
XLIFF 1.2 est le format par défaut. Utilisez --format xlf2 pour XLIFF 2.0. Les deux formats sont compatibles avec les outils TAO comme Trados Studio, memoQ et Smartcat, vous pouvez donc envoyer le fichier directement à votre traducteur vietnamien.
Comment les messages ICU pluriels se simplifient-ils en vietnamien ?
L'anglais requiert deux catégories de pluriel CLDR : one (singulier) et other. Le vietnamien n'en requiert qu'une : other. La langue exprime la quantité par des classificateurs et le contexte, non par des terminaisons de mots, donc tous les nombres se mappent sur la même forme.
Un pluriel de template anglais :
<span i18n>{count, plural, =0 {No results} one {# result} other {# results}}</span>
Devient dans messages.vi.xlf :
<target>{VAR_PLURAL, plural, =0 {Không có kết quả} other {# kết quả}}</target>
Le vietnamien dit "1 kết quả" et "5 kết quả" avec la même forme. Seuls les sélecteurs exacts =0 et =1 sont utiles pour les cas limites comme les états vides. Cette simplification réduit la surface de traduction pour toute chaîne liée à une quantité dans votre application.
Dates, nombres et devise en vietnamien : comment les pipes Angular les formatent-ils ?
Enregistrez les données de locale vietnamienne dans votre app.config.ts avant que les pipes fonctionnent correctement :
import { registerLocaleData } from '@angular/common';
import localeVi from '@angular/common/locales/vi';
registerLocaleData(localeVi, 'vi');
// Dans providers :
{ provide: LOCALE_ID, useValue: 'vi' }
Avec la locale vi active, les pipes Angular produisent une sortie vietnamienne correcte :
- DatePipe :
{{ today | date:'shortDate' }}retourne14/11/2026(DD/MM/YYYY). Les formats longs utilisent les noms de mois en vietnamien. - DecimalPipe :
{{ 1500000 | number }}retourne1.500.000. Le point est le séparateur des milliers, la virgule est le séparateur décimal en vietnamien. - CurrencyPipe :
{{ 250000 | currency:'VND' }}retourne250.000 ₫. Le VND n'a pas de subdivision décimale. - PercentPipe :
{{ 0.65 | percent }}retourne65%. Le vietnamien n'utilise pas d'espacement spécial avec le signe de pourcentage.
Ces règles de formatage proviennent du projet Unicode CLDR, la référence officielle pour les règles de formatage spécifiques aux locales. Angular inclut les données CLDR pour vi dans @angular/common/locales/vi.
Compiler la locale vi et tester la mise en page vietnamienne
Déclarez la locale vietnamienne dans angular.json sous la clé i18n du projet, puis compilez avec ng build --localize :
"i18n": {
"sourceLocale": "en-US",
"locales": {
"vi": { "translation": "src/locale/messages.vi.xlf" }
}
}
La CLI génère dist/my-app/vi/ et ajuste automatiquement le base href. Ajoutez une configuration nommée pour compiler le vietnamien indépendamment : ng build --configuration=production,vi. Servez chaque locale depuis son sous-répertoire (/vi/) et configurez votre serveur ou CDN pour rediriger selon le header Accept-Language.
Avant de publier, exécutez cette liste de contrôle de mise en page sur le build vietnamien :
- Testez tous les libellés de boutons et CTA sur des viewports mobiles de 375px et 390px. Les syntagmes nominaux composés vietnamiens s'étendent là où l'anglais utilise des verbes courts.
- Vérifiez les onglets, les fils d'Ariane et les options de liste déroulante. Les noms vietnamiens sont souvent polysyllabiques là où l'anglais utilise un seul mot ou des abréviations.
- Vérifiez la couverture des polices : le vietnamien utilise des diacritiques combinatoires (six tons plus des modifications en crochet/brève sur les voyelles de base). Vérifiez le rendu des caractères comme ộ, ề, ầ, ắ, ự, ẫ dans chaque police web chargée. Les polices système sur Android, iOS, Windows et macOS les couvrent par défaut ; les sous-ensembles allégés peuvent manquer des glyphes vietnamiens.
- Angular définit
lang="vi"sur l'élément<html>automatiquement quand la locale est correctement configurée. Appliquez aussioverflow-wrap: break-worden CSS pour éviter les débordements dans les conteneurs étroits.
Traitement interne ou spécialiste : la vraie limite pour une équipe Angular ciblant le Vietnam
Le travail d'ingénierie : installer @angular/localize, marquer les chaînes, lancer l'extraction, configurer angular.json, est entièrement réalisable en interne. N'importe quel développeur familier avec Angular CLI peut compléter la configuration en une journée. La traduction automatique fonctionne bien pour les chaînes structurées en grand volume : libellés de formulaires, messages d'erreur, textes d'info-bulle et documentation d'aide.
Là où un spécialiste vietnamien natif apporte une vraie valeur : le ton de l'interface produit, le texte marketing et la terminologie de domaine. Le vietnamien distingue les registres formel et informel, ce qui affecte le caractère professionnel d'un produit pour les utilisateurs professionnels. La terminologie sino-vietnamienne (vocabulaire dérivé du chinois classique) signale l'expertise dans la finance, les soins de santé et les produits juridiques. Un moteur de traduction automatique généraliste choisit par défaut des équivalents plus simples que les réviseurs spécialisés jugent imprécis.
La répartition pratique pour la plupart des équipes Angular : utilisez la TA avec post-édition pour la longue traîne du contenu d'aide et des messages d'erreur, et commissionnez un spécialiste humain pour les 50-100 chaînes qu'un utilisateur lit à chaque session. Pour les produits B2B où une équipe d'achat vietnamienne évaluera votre interface, prévoyez une révision complète par un locuteur natif avant le lancement.
Pour une traduction professionnelle français-vietnamien d'applications Angular et de logiciels B2B, le service de localisation de site web en vietnamien sur ce site prend en charge la traduction et la révision technique des fichiers XLIFF.
FAQ
Peut-on utiliser Trados, memoQ ou Smartcat pour traduire les fichiers XLIFF d'Angular ?
Oui. XLIFF 1.2 (.xlf) est un standard ouvert pris en charge par tous les grands outils TAO, notamment Trados Studio, memoQ, Smartcat et Lokalise. Envoyez directement le fichier messages.vi.xlf au traducteur. Prévenez les traducteurs de ne pas modifier les attributs id ni les éléments de substitution comme <x id="INTERPOLATION"/>. Certains outils proposent des filtres XLIFF spécifiques à Angular qui gèrent ces substitutions automatiquement.
Quelle est la différence entre XLIFF 1.2 et XLIFF 2.0 pour un projet vietnamien ?
Angular génère XLIFF 1.2 par défaut (.xlf). Utilisez ng extract-i18n --format xlf2 pour XLIFF 2.0 (.xlf2). XLIFF 2.0 a un schéma plus propre et un meilleur support des espaces de noms. La différence pratique pour le vietnamien est mineure : choisissez le format préféré par votre outil TAO ou agence de traduction. Les deux prennent en charge la même syntaxe ICU MessageFormat utilisée dans les templates Angular.
Faut-il utiliser 'vi' ou 'vi-VN' comme identifiant de locale dans Angular ?
Utilisez vi. Angular fournit des données de locale pour vi et vi-VN dans @angular/common/locales/, mais vi est la balise principale BCP 47 et couvre tous les utilisateurs vietnamiens. Selon les recommandations W3C sur les balises de langue, utilisez la balise la plus courte possible sauf si vous devez distinguer une variante régionale. N'utilisez vi-VN que si une bibliothèque tierce exige le code de locale complet pour sa recherche de données.
Comment tester le build vietnamien localement pendant le développement ?
Ajoutez une configuration de build nommée vi dans angular.json, puis exécutez ng serve --configuration=vi. Le serveur de développement sert la locale vietnamienne au chemin configuré. Pour tester toutes les locales simultanément, exécutez ng build --localize et servez la sortie dist/ avec un serveur statique local. La commande ng serve ne prend pas en charge les builds multi-locales à l'exécution ; utilisez l'approche build-puis-serve pour les vérifications finales avant lancement.
Que se passe-t-il pour les chaînes vietnamiennes quand le texte source change après l'extraction ?
Quand une chaîne source marquée change, Angular génère un nouvel identifiant d'unité de traduction. L'ancien identifiant dans messages.vi.xlf devient inutilisé, et le nouvel identifiant n'a pas de <target>. Le build Angular avertira des traductions manquantes. Ajoutez des identifiants personnalisés avec @@my-id pour contrôler la stabilité des identifiants : i18n="@@product-title". Cela permet de mettre à jour la chaîne source sans invalider la traduction vietnamienne, tant que le sens sémantique est inchangé.
Sources officielles
- Documentation Angular : Internationalisation - Vue d'ensemble complète du pipeline i18n, marquage du texte avec l'attribut i18n, messages ICU, extraction et fusion XLIFF. Vérifié en novembre 2026.
- Documentation Angular : Fusionner les traductions dans l'application - Configuration des locales dans angular.json, commande ng build --localize, pattern de déploiement en sous-répertoire. Vérifié en novembre 2026.
- Unicode CLDR (Common Locale Data Repository) - Données de formatage de locale officielles pour les dates, nombres et devise vietnamiens (locale vi). Vérifié en novembre 2026.
- W3C Internationalisation : Balises de langue en HTML et XML - Recommandations BCP 47 sur vi vs vi-VN et l'utilisation correcte de l'attribut lang. Vérifié en novembre 2026.

Écrit par Đào Huy (Lucas), traducteur vietnamien et spécialiste de la localisation (anglais, chinois et français vers le vietnamien). See translation services →
