loadDictionary
Référence de l’API de la fonction loadDictionary().
Aperçu
loadDictionary charge un fichier JSON de traductions pour un locale donné.
Cette fonction est destinée à celles et ceux qui souhaitent utiliser gt-next comme bibliothèque i18n autonome.
Elle est principalement utilisée pour migrer des projets existants avec i18n vers General Translation tout en conservant leurs traductions actuelles. Suivez ce guide pour la mettre en place.
S’il existe plusieurs traductions, celles des dictionaries chargés par loadDictionary auront toujours la priorité sur les autres.
loadDictionary prend uniquement en charge des fichiers JSON avec des traductions de type chaîne.
Références
Paramètres
Prop
Type
Description
| Type | Description |
|---|---|
locale | Le locale pour lequel les traductions doivent être chargées. |
Renvoie
Une Promise<any> qui se résout en un dictionary associant des id à des traductions pour le locale donné.
Configuration
En général, vous chargerez le dictionary depuis le répertoire ./public/locales.
Définissez loadDictionary comme export par défaut d’un fichier nommé loadDictionary.js ou loadDictionary.ts, soit dans le répertoire src/, soit à la racine.
Assurez-vous que la fonction renvoie une promesse résolue avec un objet contenant les traductions pour le locale donné.
export default async function loadDictionary(locale) {
const translations = await import(`../public/locales/${locale}.json`);
return translations.default;
}Question : Quelle est la différence entre loadTranslations et loadDictionary ?
loadTranslationssert à définir un comportement de chargement personnalisé pour récupérer les traductions de votre application. Cela peut passer par un CDN (Content Delivery Network), une base de données ou le bundle de votre application. Il s’agit généralement de traductions générées automatiquement, gérées par l’outil CLI, et peu pratiques à modifier.loadDictionaryest destiné aux intégrations degt-nextutilisées comme bibliothèque autonome. Les utilisateurs fournissent leurs propres traductions et aucune infrastructure de traduction n’est utilisée.
Remarques
loadDictionaryest utilisé pour charger des traductions personnalisées pour votre application.- Les dictionaries chargés par
loadDictionaryauront priorité sur les traductions chargées parloadTranslations.
Prochaines étapes
- Si vous souhaitez écrire vos propres traductions, consultez les traductions personnalisées.
- Consultez
loadTranslationspour en savoir plus sur la création d’un chargeur de traductions personnalisé.
Que pensez-vous de ce guide ?