Localiser une app React Native en vietnamien: Expo, i18n, VND et dates

💡 React Native ajoute le vietnamien en un après-midi: installez expo-localization, lisez getLocales()[0].languageCode pour détecter vi, connectez i18n-js ou react-i18next pour les traductions, formatez le VND avec Intl.NumberFormat('vi-VN', { style: 'currency', currency: 'VND', maximumFractionDigits: 0 }) et affichez les dates en dd/MM/yyyy. Les noms vietnamiens ne s'accordent jamais en nombre, donc une seule clé de traduction suffit pour toutes les quantités.

Comment détecter et activer le vietnamien dans une app React Native?

Le package expo-localization est la méthode recommandée pour lire la locale de l'appareil. Installez-le avec npx expo install expo-localization, puis appelez getLocales() au démarrage:

import { getLocales } from 'expo-localization';

const deviceLang = getLocales()[0]?.languageCode ?? 'en'; // 'vi' sur appareil en vietnamien
const deviceTag  = getLocales()[0]?.languageTag  ?? 'en-US'; // 'vi-VN'

getLocales() renvoie la liste de préférences linguistiques de l'utilisateur. Le premier élément est la locale principale. Pour le vietnamien, languageCode vaut vi et languageTag vaut vi-VN. Passez deviceLang à votre librairie de traduction comme langue initiale, stocké en React state ou context pour que l'interface se mette à jour quand l'utilisateur change la langue du système.

Pour les projets bare React Native sans Expo, le package communautaire react-native-localize fournit la même API getLocales().

Quelle librairie de traduction choisir pour le vietnamien?

La documentation Expo liste quatre choix: i18n-js, react-i18next, Lingui et Intlayer. Le vietnamien fonctionne bien avec tous. Les compromis pratiques:

• i18n-js: léger (~10 ko), fichiers JSON simples, facile à maintenir pour les non-développeurs. Idéal pour les petites et moyennes applications où les traducteurs éditent directement le JSON.
• react-i18next: la solution la plus utilisée dans l'écosystème. Prend en charge ICU MessageFormat, les espaces de noms, le chargement paresseux et les plugins backend pour charger les traductions à distance. Meilleur choix pour les applications multi-écrans ou les workflows avec un TMS (Trados, Crowdin, Lokalise).
• Lingui: excellente ergonomie TypeScript et extraction de chaînes à la compilation. Pour les équipes qui valorisent la sécurité de types.

Les trois exportent des fichiers de traduction en JSON. Un traducteur vietnamien peut travailler avec n'importe lequel sans toucher au code.

Comment fonctionnent les règles de pluriel en vietnamien dans les librairies i18n?

Les règles de pluriel Unicode CLDR définissent deux catégories pour le vietnamien: one (n = 0 ou 1) et other (toutes les autres valeurs). Contrairement au français, les noms vietnamiens n'ont pas de forme plurielle. « 1 sản phẩm » et « 5 sản phẩm » utilisent le même mot. En pratique, la traduction other couvre tous les cas, avec une entrée distincte pour l'état vide:

// Fichier de traduction i18n-js: vi.json
{
  "cart": {
    "items_zero": "Giỏ hàng trống",
    "items_one":  "{{count}} sản phẩm",
    "items_other":"{{count}} sản phẩm"
  }
}

items_one et items_other sont identiques - c'est intentionnel. Les classificateurs nominaux vietnamiens (cái, con, chiếc) varient selon la catégorie du nom, mais c'est un attribut fixe de chaque nom, pas une règle grammaticale variant avec la quantité. La traduction automatique choisit souvent le mauvais classificateur, ce qu'un relecteur natif repère immédiatement.

Formatage du VND et des dates en React Native

Intl.NumberFormat de JavaScript est disponible sur iOS et Android via JSC/Hermes. Pour le VND, définissez maximumFractionDigits: 0 - le dong n'a pas de sous-unités. Le vietnamien utilise le point (.) pour les milliers et la virgule (,) pour le séparateur décimal, l'inverse de l'anglais américain:

const vndFmt = new Intl.NumberFormat('vi-VN', {
  style: 'currency',
  currency: 'VND',
  maximumFractionDigits: 0,
});

vndFmt.format(1250000); // "1.250.000 ₫"

Omettre maximumFractionDigits: 0 produira un incorrect "1.250.000,00 ₫" sur certaines versions de runtime. Définissez-le toujours explicitement.

L'ordre des dates vietnamiennes est jour-mois-année. Le 11 octobre 2026 s'écrit « 11/10/2026 ». Un utilisateur vietnamien qui voit « 10/11 » lit le 10 novembre. Utilisez Intl.DateTimeFormat avec la locale vi-VN ou date-fns avec la locale vi.

Pourquoi le texte vietnamien prend-il plus de place à l'écran?

Le vietnamien combine une lettre de base avec jusqu'à deux diacritiques empilées. Le caractère « ộ » (o + accent circonflexe + point en dessous) est visuellement plus large qu'une lettre latine ordinaire. Les chaînes vietnamiennes sont en moyenne 20 à 30% plus longues que leurs équivalents anglais. « Settings » (8 caractères) devient vietnamien plus court en nombre de caractères mais plus large visuellement.

Construisez vos layouts Flexbox avec des largeurs flexibles. Utilisez flex: 1 plutôt qu'une width fixe pour les boutons et onglets. Testez avec le vietnamien actif avant la mise en production. Le rapport DataReportal 2025 sur le Vietnam recense 127 millions de connexions mobiles pour 101 millions d'habitants - la quasi-totalité des utilisateurs vietnamiens accède à votre application via un smartphone.

Ce que vous pouvez faire en interne vs quand un relecteur vietnamien natif est justifié

Toute la partie technique - expo-localization, librairie i18n, formatage Intl - est à la portée de votre équipe en quelques heures. Les chaînes obtenues seront syntaxiquement correctes. Les limites fréquentes de la traduction non native du vietnamien:

• Décalage de registre: les logiciels B2B fintech et d'entreprise utilisent le vocabulaire sino-vietnamien, les applications grand public le vietnamien courant. Mélanger les deux dans la même interface désoriente les locuteurs natifs.
• Erreurs de classificateurs: con pour les animaux, cái pour les objets inanimés, chiếc pour les véhicules. La traduction automatique se trompe souvent et les utilisateurs natifs le remarquent immédiatement.
• Cas limites UI: les messages d'erreur, états vides et confirmations nécessitent un vietnamien naturel. Un phrasé maladroit à ces moments clés nuit à la confiance de l'utilisateur.

Une seule passe de relecture par un spécialiste de la localisation vietnamienne après une première traduction automatique détecte la plupart de ces problèmes. Pour les applications fintech, médicales ou juridiques, établissez un glossaire terminologique avant la première passe de traduction.

FAQ

Sources officielles

• Guide Expo Localization - package expo-localization, API getLocales(), librairies de traduction recommandées. Vérifié en novembre 2026.
• MDN Intl.NumberFormat - options de formatage de devise, maximumFractionDigits. Vérifié en novembre 2026.
• Règles de pluriel Unicode CLDR - catégories de pluriel vietnamiennes (one/other). Vérifié en novembre 2026.
• DataReportal Digital 2025: Vietnam - 127 millions de connexions mobiles, 101 millions d'habitants, 79,8 millions d'internautes. Vérifié en novembre 2026.