💡 Pour localiser une application SvelteKit en vietnamien avec Paraglide JS : lancez
npx sv add paraglide, ajoutezvidans le tableau languageTags de project.inlang/settings.json, configurez le middleware danshooks.server.tset importez les fonctions de messages typées. Le vietnamien n'a qu'une seule catégorie de pluriel ICU (other), ce qui simplifie les messages pluriels en une seule branche. Les chaînes vietnamiennes sont 10-20% plus longues que l'anglais.
À retenir
- Lancez
npx sv add paraglidepour créer la structure Paraglide JS + SvelteKit complète en une seule commande. La CLI créeproject.inlang/settings.json, un dossiermessages/et connecte automatiquement le plugin Vite. - Ajoutez
vidans le tableaulanguageTagsdeproject.inlang/settings.json. Créezmessages/vi.jsonavec vos traductions vietnamiennes en utilisant les mêmes ID de messages que votre locale de base. - Le vietnamien n'a qu'une seule catégorie de pluriel CLDR :
other. Tous les messages ICU pluriels se simplifient en une seule branche sans formeonedistincte. - Utilisez
paraglideMiddlewaredanshooks.server.tset le hook de reroutagedeLocalizeUrldanshooks.tspour les URL préfixées et l'injection SSR correcte. - Les chaînes vietnamiennes sont 10-20% plus longues que l'anglais. Testez tous les libellés de boutons et éléments de navigation en viewports 375px et 390px. Les sous-ensembles de polices web doivent couvrir le bloc Unicode vietnamien complet (U+1EA0-U+1EF9).
Que nécessite vraiment la localisation SvelteKit en vietnamien ?
Localiser une application SvelteKit en vietnamien couvre quatre problèmes distincts : la gestion des messages, le routage par locale, le formatage des nombres et des dates, et les tests de mise en page. Ces problèmes sont indépendants, et vous pouvez les résoudre un par un sans que l'un bloque l'autre.
Paraglide JS gère la gestion des messages et le routage par locale. L'API JavaScript Intl gère le formatage avec la locale vi-VN. Les tests de mise en page sont une étape manuelle qui révèle les problèmes de polices et de longueur de chaînes propres au vietnamien.
Le rendu côté serveur de SvelteKit ajoute une exigence : la locale doit être détectée par requête sur le serveur et transmise au client. Le middleware de Paraglide gère cela via hooks.server.ts.
Pourquoi Paraglide JS est la bibliothèque i18n recommandée pour SvelteKit
Paraglide JS compile vos fichiers de messages en fonctions ESM typées au moment du build. Les bundlers modernes élaguent ensuite les fonctions de messages inutilisées, envoyant uniquement le code de la locale active au navigateur. Le résultat est des bundles plus légers comparés aux bibliothèques de dictionnaires en temps d'exécution.
SvelteKit a officiellement adopté Paraglide JS comme solution i18n recommandée via la CLI Svelte. Lancer npx sv add paraglide gère automatiquement toute la structure : le plugin Vite, le fichier de projet inlang, les hooks et un dossier de messages d'exemple.
Les bibliothèques alternatives fonctionnent toujours. Typesafe-i18n et svelte-i18n sont des options matures avec un support vietnamien. Mais pour les nouveaux projets SvelteKit, Paraglide est la recommandation officielle de l'équipe Svelte.
Comment configurer Paraglide JS pour le vietnamien dans SvelteKit ?
La configuration se fait en quatre étapes. Tous les fichiers doivent être édités avec un outil compatible UTF-8 pour préserver les diacritiques vietnamiens.
Étape 1 - Structure : Lancez la commande Svelte CLI pour créer la structure complète :
npx sv add paraglide
Cette commande génère project.inlang/settings.json, connecte le plugin Vite à vite.config.ts et crée messages/en.json comme fichier de locale de base.
Étape 2 - Ajouter la locale vietnamienne. Dans project.inlang/settings.json, ajoutez vi au tableau languageTags :
{ "languageTags": ["en", "vi"], "baseLocale": "en" }
Étape 3 - Créer messages/vi.json avec vos chaînes vietnamiennes. Utilisez les mêmes ID de messages que votre fichier de locale de base. Les diacritiques vietnamiens doivent être stockés en UTF-8 NFC :
{ "greeting": "Xin chào, {name}!", "items_in_cart": "{count} sản phẩm trong giỏ hàng", "checkout_button": "Thanh toán" }
Étape 4 - Ajouter le middleware dans src/hooks.server.ts et le hook de reroutage dans src/hooks.ts :
// hooks.server.ts
import type { Handle } from '@sveltejs/kit/hooks';
import { paraglideMiddleware } from '$lib/paraglide/server';
export const handle: Handle = ({ event, resolve }) =>
paraglideMiddleware(event.request, ({ request: localizedRequest }) =>
resolve({ ...event, request: localizedRequest }));
// hooks.ts
import type { Reroute } from '@sveltejs/kit/hooks';
import { deLocalizeUrl } from '$lib/paraglide/runtime';
export const reroute: Reroute = ({ url }) => deLocalizeUrl(url).pathname;
Formatage vietnamien : dates, nombres et devise
Paraglide gère quelle chaîne afficher. L'API JavaScript Intl gère la façon dont les nombres, les dates et la devise s'affichent. Utilisez le code de locale vi-VN pour les trois :
- Dates :
new Intl.DateTimeFormat('vi-VN', { dateStyle: 'short' }).format(date)retourne DD/MM/YYYY. Les utilisateurs vietnamiens s'attendent au jour en premier. - Nombres :
new Intl.NumberFormat('vi-VN').format(1500000)retourne1.500.000. Le point est le séparateur des milliers ; la virgule est le séparateur décimal, à l'inverse du français. - Devise (VND) :
new Intl.NumberFormat('vi-VN', { style: 'currency', currency: 'VND' }).format(250000)retourne250.000 ₫. Le VND n'a pas de subdivision décimale. - Tri : L'ordre alphabétique vietnamien diffère de l'ASCII. Utilisez
new Intl.Collator('vi').comparepour toute liste triée côté client. L'alphabet vietnamien compte 29 lettres de base.
Quels problèmes de mise en page attendre avec les chaînes vietnamiennes ?
Les chaînes vietnamiennes sont typiquement 10-20% plus longues que leurs équivalents anglais dans les libellés UI et le texte de navigation. L'allongement vient des termes polysyllabiques et des particules grammaticales sans équivalent en anglais.
Vérifiez cette liste avant de lancer votre application SvelteKit vietnamienne :
- Testez tous les textes de boutons et libellés de navigation aux largeurs de viewport 375px et 390px.
- Vérifiez la couverture des polices : le vietnamien utilise des diacritiques combinatoires avec six marques de ton. Les sous-ensembles de polices web limités au latin de base peuvent manquer des glyphes vietnamiens. Ajoutez les plages Unicode :
U+0102-0103, U+0110-0111, U+1EA0-1EF9. - Définissez
lang="vi"sur l'élément<html>racine. Le templateapp.htmlde SvelteKit supporte un placeholder%lang%que Paraglide remplit au moment de la requête. - Appliquez
overflow-wrap: break-worddans votre CSS de base. Le texte vietnamien se coupe aux espaces entre les mots-syllabes, mais les longs termes techniques peuvent déborder des conteneurs étroits. - Normalisez toutes les saisies en chaînes vietnamiennes vers NFC. Les diacritiques vietnamiens peuvent être encodés en NFC précomposé ou NFD décomposé, visuellement identiques mais échouant aux comparaisons de chaînes. Utilisez
str.normalize('NFC')pour tout texte vietnamien saisi par l'utilisateur.
Traitement interne ou spécialiste : la vraie limite pour une application SvelteKit vietnamienne
Le travail technique, notamment la configuration de Paraglide, l'écriture des hooks et le câblage d'Intl, est entièrement réalisable en interne. N'importe quel développeur peut suivre le guide officiel Paraglide JS + SvelteKit et avoir la couche de routage opérationnelle en quelques heures. La traduction automatique gère les chaînes UI structurées comme les messages d'erreur, les libellés de champs et les textes d'aide avec une qualité acceptable pour la plupart des applications.
Là où un spécialiste vietnamien natif fait une réelle différence : le ton de l'interface produit, le texte marketing et la terminologie spécialisée. Le vietnamien distingue un registre formel (utilisé dans les applications professionnelles) d'un registre informel (utilisé dans les applications grand public), et un mauvais choix se perçoit immédiatement. Le vocabulaire sino-vietnamien transmet l'expertise dans les produits financiers, médicaux et juridiques, mais les moteurs de traduction automatique généralistes utilisent par défaut des équivalents vietnamiens purs que les spécialistes jugent imprécis.
La répartition pratique : utilisez la TA pour le contenu d'aide à longue traîne, et confiez à un réviseur humain les 50-100 chaînes UI qu'un utilisateur rencontre à chaque session. Pour les produits B2B où une équipe d'achat vietnamienne évaluera le produit, faites auditer l'interface complète par un locuteur natif avant le lancement.
Pour une localisation professionnelle de sites web et d'interfaces SaaS en vietnamien à partir du français, le service de localisation de site web en vietnamien sur ce site prend en charge la traduction et la révision technique.
FAQ
Le vietnamien nécessite-t-il une normalisation Unicode spéciale dans les fichiers de messages Paraglide ?
Oui. Les diacritiques vietnamiens peuvent être encodés en NFC précomposé (un seul point de code par caractère) ou en NFD décomposé (caractère de base plus marques combinatoires). Les deux ont le même rendu visuel dans le navigateur, mais les vérifications d'égalité de chaînes échouent. Stockez tout le contenu des fichiers de messages vietnamiens en NFC. En JavaScript : str.normalize('NFC').
Faut-il utiliser 'vi' ou 'vi-VN' comme code de locale dans Paraglide ?
Utilisez vi dans les languageTags de Paraglide et comme préfixe d'URL. Selon les recommandations W3C BCP 47, les balises de langue doivent être aussi courtes que possible. Pour l'API JavaScript Intl, vi-VN est plus explicite et garantit une recherche de données de formatage cohérente, mais vi fonctionne pour la plupart des opérations.
Comment Paraglide gère-t-il les messages pluriels vietnamiens ?
Le vietnamien n'a qu'une seule catégorie de pluriel CLDR : other. Tous les nombres correspondent à other car le vietnamien exprime la quantité via des classificateurs nominaux. La syntaxe ICU {count, plural, other {# sản phẩm}} couvre toutes les quantités. Les sélecteurs =0 et =1 restent disponibles pour les messages d'état vide spécifiques.
Comment fonctionnent les URL préfixées par locale avec Paraglide dans SvelteKit ?
Paraglide ajoute un préfixe de locale à toutes les URL : vos pages vietnamiennes sont servies sous /vi/votre-route. Le hook reroute dans hooks.ts supprime le préfixe de locale pour que le routeur basé sur les fichiers de SvelteKit voie le chemin non localisé. Le paraglideMiddleware dans hooks.server.ts détecte la locale depuis le préfixe URL et la définit pour la requête via AsyncLocalStorage.
Peut-on utiliser Paraglide JS avec l'adaptateur statique de SvelteKit pour un site entièrement statique ?
Oui. Paraglide JS fonctionne avec @sveltejs/adapter-static. Définissez strategy: ['url', 'baseLocale'] dans la configuration du plugin Vite Paraglide et prérendez toutes les variantes de locale. Ajoutez entries: ['/vi/', '/en/', '/zh/', '/fr/'] à votre configuration d'adaptateur statique pour que SvelteKit génère du HTML pour chaque locale. Les fonctions de messages compilées sont des ESM statiques et ne nécessitent aucun serveur en production.
Sources officielles
- Paraglide JS : Guide d'intégration SvelteKit - Documentation officielle de configuration : npx sv add paraglide, middleware hooks.server.ts, configuration du plugin Vite. Vérifié en novembre 2026.
- Unicode CLDR : Règles de pluriel par langue - Catégories de pluriel CLDR pour le vietnamien (catégorie unique "other"). Vérifié en novembre 2026.
- W3C Internationalisation : Choisir une balise de langue - Recommandations BCP 47 sur vi vs vi-VN pour le vietnamien. Vérifié en novembre 2026.
- Google Search Central : Versions localisées - Exigences hreflang pour les sites SvelteKit multilingues. 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 →
