loadDictionary()

Overview

loadDictionary() will load a translation json file for a given locale.

This function is intended for those who which to use gt-next as a stand-alone i18n library.

This function is primarily used to migrate existing projects with i18n to General Translation while keeping their existing translations. Follow this guide to set this up.

If multiple translations exist, translations from dictionaries loaded by loadDictionary() will always take precedence over others. loadDictionary() only supports the use of JSON files with string translations.

Reference

Parameters

Description

Returns

A Promise<any> that resolves to dictionary mapping ids to translations for the given locale.

Setup

Generally, you will load the dictionary from the ./public/locales directory.

Define your loadDictionary() as the default export for a file with the name loadDictionary.js or loadDictionary.ts either in the src/ directory or the root. Make sure to have the function return a promise that resolves to an object with translations for the given locale.

export default async function loadDictionary(locale) {
  const translations = await import(`../public/locales/${locale}.json`);
  return translations.default;
}

Notes

• loadDictionary() is used to load custom translations for your app.
• Dictionaries loaded by loadDictionary() will take precedence over translations loaded by loadTranslations().

Next steps

• If you want to write your own translations check out custom translations.
• See loadTranslations() for more information on writing a custom translation loader.