Vous m'avez trouvé sur Upwork ? Si vous m'avez trouvé via Upwork et souhaitez faire appel à mes services, merci de me contacter via Upwork. Les messages de clients Upwork envoyés en dehors d'Upwork ne recevront pas de réponse.
Notes de localisation🌏 Localisation

Vue.js et Nuxt.js en vietnamien : guide vue-i18n et lazy-loading

Le vietnamien n'a pas de pluriel grammatical: un seul message par clé. Configurez vue-i18n, Nuxt i18n hreflang et lazy-loading pour cibler le marché vietnamien.

Dao Huy (Lucas)5 min de lecture8 sections
Vue.js et Nuxt.js en vietnamien : guide vue-i18n et lazy-loading
💡 En bref : Ajoutez vi comme locale dans vue-i18n et définissez language: 'vi-VN' dans Nuxt pour générer les balises hreflang correctes. Le vietnamien n'a pas de pluriel grammatical : Unicode CLDR ne lui attribue que la catégorie "other", donc une seule chaîne de message suffit pour tous les décomptes. Appelez useLocaleHead() dans votre layout racine pour injecter automatiquement les balises <link rel="alternate" hreflang="vi-VN"> que Google requiert.

À retenir

  • Utilisez vi dans vue-i18n ; définissez language: 'vi-VN' dans le tableau locales de Nuxt pour générer des balises hreflang conformes à BCP 47.
  • Le vietnamien n'a pas de pluriel grammatical (Unicode CLDR : catégorie "other" uniquement) ; aucune option pluralizationRules n'est nécessaire.
  • Activez le chargement différé avec file: 'vi.json' par locale pour ne pas alourdir le bundle JS initial.
  • Enregistrez tous les fichiers JSON de traduction en UTF-8 sans BOM - un BOM peut corrompre les diacritiques vietnamiennes dans certains analyseurs JSON.
  • Appelez useLocaleHead({ addSeoAttributes: true }) dans votre layout racine pour injecter hreflang, canonical et og:locale en un seul composable.

Pourquoi le pluriel vietnamien est plus simple que le français

Le vietnamien exprime la quantité avec des numéraux et des classificateurs, sans modifier la forme des noms. "1 sản phẩm" et "10 sản phẩm" ont exactement la même structure. Unicode CLDR attribue au vietnamien uniquement la catégorie "other", ce qui signifie qu'une seule chaîne de message par clé suffit, quel que soit le décompte.

Comparez cela au français, qui nécessite "one" et "other", ou à l'anglais, qui utilise aussi deux formes. Votre fichier vi.json n'a pas besoin des variantes séparées par des pipes que le français et l'anglais exigent :

// fr.json
{
  "cartItems": "Aucun article | Un article | {count} articles"
}

// vi.json - une seule forme, pas de pipe nécessaire
{
  "cartItems": "{count} sản phẩm"
}

Si une règle métier nécessite un message spécial pour zéro (par exemple "Panier vide"), gérez-le dans la logique du composant plutôt que via la pluralisation de vue-i18n.

Comment configurer la locale vietnamienne dans vue-i18n ?

Utilisez vi comme code de locale. Les recommandations W3C préconisent de garder les tags BCP 47 aussi courts que possible : le sous-tag régional -VN n'apporte aucune distinction fonctionnelle pour vue-i18n, puisqu'il n'existe qu'une seule orthographe vietnamienne standard. Configurez-le dans createI18n() :

import { createI18n } from 'vue-i18n'

const i18n = createI18n({
  locale: 'vi',
  fallbackLocale: 'fr',
  messages: {
    vi: {
      welcome: 'Chào mừng, {name}!',
      cartItems: '{count} sản phẩm',
      checkout: 'Thanh toán ngay'
    }
  }
})

Aucune option pluralizationRules n'est requise. La règle par défaut de Vue i18n retourne "other" pour toutes les valeurs numériques, ce qui est exactement le comportement attendu pour le vietnamien.

Comment Nuxt i18n génère-t-il les hreflang pour le vietnamien ?

Nuxt i18n v10 utilise le module @nuxtjs/i18n. Pour la génération du hreflang, la propriété language de chaque objet locale doit être un tag BCP 47, et baseUrl doit pointer vers votre domaine de production :

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@nuxtjs/i18n'],
  i18n: {
    locales: [
      { code: 'fr', language: 'fr-FR', file: 'fr.json' },
      { code: 'vi', language: 'vi-VN', file: 'vi.json' }
    ],
    defaultLocale: 'fr',
    baseUrl: 'https://votre-domaine.com',
    strategy: 'prefix_except_default'
  }
})

La stratégie prefix_except_default laisse le français sur l'URL racine et donne au vietnamien le préfixe /vi/, permettant à Google d'indexer les deux versions de langue séparément. Appelez useLocaleHead({ addSeoAttributes: true }) dans votre layout racine : ce composable génère automatiquement <link rel="alternate" hreflang="vi-VN"> pour chaque page, plus le lien x-default et l'URL canonique.

Faut-il charger les traductions vietnamiennes en différé ?

Oui. Si le vietnamien n'est pas votre locale par défaut, inclure ses chaînes dans le bundle JS initial gaspille de la bande passante pour les visiteurs non vietnamiens. La clé file sur chaque objet locale active le chargement différé : Nuxt i18n récupère vi.json uniquement lorsqu'un utilisateur navigue vers une route vietnamienne, puis le met en cache pour la session.

// locales/vi.json
{
  "home": {
    "hero": "Giải pháp dịch thuật chuyên nghiệp",
    "cta": "Yêu cầu báo giá"
  },
  "nav": {
    "about": "Giới thiệu",
    "contact": "Liên hệ"
  }
}

Note d'encodage : enregistrez tous les fichiers JSON de traduction en UTF-8 sans BOM. Les diacritiques vietnamiennes (U+1E00 à U+1EFF) sont encodées en séquences UTF-8 de 3 octets. Certains éditeurs Windows ajoutent un BOM qui peut provoquer des caractères corrompus dans certains analyseurs JSON.

Ce que vous pouvez gérer en interne, et quand un spécialiste vietnamien est rentable

Toute la configuration technique présentée - vue-i18n, Nuxt, hreflang et chargement différé - est un travail interne. Les outils de traduction automatique comme DeepL et Google Traduction gèrent correctement les chaînes d'interface simples en vietnamien.

Un spécialiste vietnamien natif est justifié pour :

  • Le choix du registre : Le vietnamien distingue un registre formel (kính/quý khách) et un registre informel (bạn). Un mauvais registre dans une application fintech ou médicale nuit immédiatement à la confiance des utilisateurs vietnamiens.
  • La terminologie sino-vietnamienne : Le vocabulaire financier, juridique et médical a souvent deux traductions vietnamiennes valides - un terme sino-vietnamien (formel, technique) et un équivalent vietnamien pur (accessible, courant). Ce choix est un jugement culturel que la traduction automatique ne peut pas gérer.
  • Les courtes chaînes d'interface : Les libellés de boutons et les messages d'erreur courts, sans contexte, sont les points où la traduction automatique échoue le plus souvent en vietnamien.

Une journée de révision par un professionnel vietnamien natif sur une première traduction automatique coûte généralement bien moins cher que de retraduire après les retours des utilisateurs. Le service de localisation de sites et applications en vietnamien sur ce site associe une révision technique à un contrôle qualité humain pour les projets Vue et Nuxt.

FAQ

Faut-il utiliser vi ou vi-VN comme code de locale dans vue-i18n ?

Utilisez vi dans le paramètre locale de vue-i18n et dans les noms de fichiers (vi.json). Définissez language: 'vi-VN' dans le tableau locales de Nuxt i18n pour générer la balise hreflang BCP 47. Les deux paramètres ont des rôles distincts : correspondance des messages dans vue-i18n d'un côté, signalement de la langue aux moteurs de recherche de l'autre.

Des règles pluralizationRules personnalisées sont-elles nécessaires pour le vietnamien ?

Non. Le vietnamien n'a pas de pluriel grammatical : Unicode CLDR ne lui attribue que la catégorie "other". La règle de pluralisation par défaut de Vue i18n retourne "other" pour toutes les valeurs numériques, ce qui est exactement ce qu'il faut pour le vietnamien. Omettez l'option pluralizationRules et rédigez des chaînes de messages sous forme unique.

Comment vérifier que les balises hreflang vietnamiennes sont correctes ?

Construisez votre site et vérifiez la source HTML pour trouver les balises <link rel="alternate" hreflang="vi-VN">. L'attribut href doit être une URL complète (https://...). Utilisez l'outil d'inspection d'URL de Google Search Console pour confirmer que Google a analysé le hreflang après le déploiement.

Mes chaînes vietnamiennes s'affichent en caractères corrompus. Quelle est la cause ?

La cause la plus fréquente est un BOM UTF-8 dans les fichiers JSON de locale. Vérifiez la barre d'état de VS Code : si elle indique "UTF-8 with BOM", réenregistrez en "UTF-8". Une autre cause courante : la lecture de fichiers avec PowerShell 5.x Get-Content, qui utilise par défaut Windows-1252 et corrompt silencieusement les caractères multi-octets vietnamiens. Utilisez toujours les fonctions fs de Node.js (readFileSync(path, 'utf8')) pour lire et écrire les fichiers de locale.

Puis-je réutiliser les mêmes messages vue-i18n dans une SPA Vue et une application Nuxt ?

Oui. Vue i18n est la bibliothèque sous-jacente dans les deux cas. Le format des fichiers JSON de messages, la syntaxe d'interpolation et les règles de pluriel sont identiques. Nuxt ajoute simplement le routage, le hreflang et le chargement différé par-dessus. Si vous migrez d'une SPA Vue vers Nuxt, vos fichiers locales/vi.json existants fonctionnent sans modification.

Sources officielles

Dao Huy (Lucas)
Dao Huy (Lucas)
Diplômé de l'Université des langues étrangères, Université de Da Nang. Signe une attestation d'exactitude sur chaque traduction certifiée (USCIS, IRCC).

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

DevisWhatsApp