Config

loadDictionary()

API-Referenz für die Funktion loadDictionary().

Übersicht

loadDictionary() lädt eine Übersetzungs-JSON-Datei für eine angegebene Locale.

Diese Funktion ist für diejenigen gedacht, die gt-react als eigenständige i18n-Bibliothek verwenden möchten.

Diese Funktion wird hauptsächlich verwendet, um bestehende Projekte mit i18n auf General Translation umzustellen, während die vorhandenen Übersetzungen beibehalten werden.

Wenn mehrere Übersetzungen existieren, haben Übersetzungen aus Wörterbüchern, die mit loadDictionary() geladen wurden, immer Vorrang vor anderen. loadDictionary() unterstützt nur die Verwendung von JSON-Dateien mit Zeichenkettenübersetzungen.

Referenz

Parameter

PropTypeDefault
locale?
string
-

Beschreibung

TypBeschreibung
localeDas Gebietsschema, für das Übersetzungen geladen werden sollen.

Rückgabewert

Ein Promise<any>, das auf ein Wörterbuch aufgelöst wird, das IDs den Übersetzungen für das angegebene Gebietsschema zuordnet.


Einrichtung

In der Regel lädst du das Wörterbuch aus dem Verzeichnis ./public/locales.

Definiere deine Funktion loadDictionary() in einer Datei. Stelle sicher, dass die Funktion ein Promise zurückgibt, das zu einem Objekt mit Übersetzungen für die angegebene Sprache aufgelöst wird.

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

Übergebe sie dann an deine <GTProvider> Komponente:

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

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

Frage: Was ist der Unterschied zwischen loadTranslations() und loadDictionary()?

  • loadTranslations() wird verwendet, um ein benutzerdefiniertes Ladeverhalten für das Abrufen von Übersetzungen für deine App zu definieren. Dies kann das Laden von Übersetzungen von einem CDN, einer Datenbank oder aus dem Bundle deiner App sein. Diese Übersetzungen sind in der Regel maschinell generiert, werden vom CLI-Tool verwaltet und sind nicht besonders benutzerfreundlich zu bearbeiten.
  • loadDictionary() ist für Implementierungen von gt-react als eigenständige Bibliothek gedacht. Die Nutzer bringen ihre eigenen Übersetzungen mit, und es wird keine Übersetzungsinfrastruktur verwendet.

Hinweise

  • loadDictionary() wird verwendet, um benutzerdefinierte Übersetzungen für Ihre App zu laden.
  • Wörterbücher, die mit loadDictionary() geladen werden, haben Vorrang vor Übersetzungen, die mit loadTranslations() geladen werden.

Nächste Schritte

Wie ist dieser Leitfaden?