Dashboard
Config

loadDictionary

Riferimento API per la funzione loadDictionary().

Panoramica

loadDictionary carica un file JSON di traduzioni per una determinata locale.

Questa funzione è pensata per chi desidera usare gt-react come libreria i18n stand‑alone.

Questa funzione è utilizzata principalmente per migrare progetti i18n esistenti a General Translation mantenendo le traduzioni già presenti.

Se sono disponibili più traduzioni, quelle provenienti dai dizionari caricati da loadDictionary avranno sempre la precedenza sulle altre. loadDictionary supporta solo file JSON con traduzioni di tipo stringa.

Riferimenti

Parametri

Prop

Type

Descrizione

TipoDescrizione
localeIl locale per cui devono essere caricate le traduzioni.

Restituisce

Una Promise<any> che risolve in un dizionario che associa gli ID alle traduzioni per la locale specificata.

Configurazione

In genere, il dizionario viene caricato dalla directory ./public/locales.

Definisci loadDictionary in un file. Assicurati che la funzione restituisca una Promise che si risolve in un oggetto con le traduzioni per la locale specificata.

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

Quindi passalo al componente <GTProvider>:

src/App.js
import { GTProvider } from 'gt-react';
import loadDictionary from './loadDictionary';

<GTProvider loadDictionary={loadDictionary}>
  <App />
</GTProvider>

Domanda: Qual è la differenza tra loadTranslations e loadDictionary?

  • loadTranslations si usa per definire un comportamento di caricamento personalizzato per il recupero delle traduzioni dell’app. Può ad esempio prelevare le traduzioni da un CDN, da un database o dal bundle dell’app. Di norma si tratta di traduzioni generate automaticamente, gestite dallo strumento CLI e poco pratiche da modificare manualmente.
  • loadDictionary è pensato per usare gt-react come libreria autonoma. Gli utenti forniscono le proprie traduzioni e non si utilizza alcuna infrastruttura di traduzione.

Note

  • loadDictionary viene utilizzato per caricare traduzioni personalizzate per la tua app.
  • I dizionari caricati con loadDictionary avranno la precedenza sulle traduzioni caricate da loadTranslations.

Prossimi passaggi

Come valuti questa guida?

In questa pagina

Panoramica
Riferimenti
Parametri
Descrizione
Restituisce
Configurazione
Note
Prossimi passaggi
loadDictionary