json (.json)

JSON est le format de localisation le plus largement utilisé pour les applications web. Les applications React utilisant i18next ou react-i18next stockent les traductions sous forme d'objets JSON plats ou imbriqués. Les applications Vue.js utilisant vue-i18n utilisent JSON nativement. Next.js, Angular, les backends Node.js et la plupart des frameworks JavaScript ont un support natif de JSON. Language Monster détecte automatiquement la structure de votre fichier de locale JSON et gère les deux mises en page, plate et imbriquée.

Le JSON plat mappe directement les clés de chaînes aux valeurs traduites. Le JSON imbriqué organise les clés en espaces de noms — par exemple, auth.login.button est une chaîne imbriquée dans un objet auth à l'intérieur d'un objet login. i18next accède aux clés imbriquées en utilisant la notation par points. Les fichiers de traduction sont nommés par code de locale : en.json, fr.json, de.json. L'interpolation utilise des noms de variables entre doubles accolades ; les formes plurielles utilisent la convention de suffixe _one et _other dans i18next ou le séparateur pipe dans vue-i18n.

Bonne pratique : divisez les fichiers de locale par espace de noms de fonctionnalité plutôt que de conserver un fichier volumineux par locale. Cela permet le chargement différé uniquement des chaînes dont une page a besoin, réduisant le poids initial du bundle. Nommez les clés de manière sémantique — checkout.submit est plus stable que button_14. Évitez de construire des clés dynamiquement à l'exécution car cela brise les outils d'analyse statique. Exécutez eslint-plugin-i18next en CI pour détecter les chaînes codées en dur non traduites avant qu'elles n'atteignent la production.

Guides de localisation pour développeurs

Localisation React & Next.js

Localisation Vue.js & Nuxt

En savoir plus Formats de fichiers