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
Prop | Type | Default |
---|---|---|
locale? | string | - |
Beschreibung
Typ | Beschreibung |
---|---|
locale | Das 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.
export default async function loadDictionary(locale) {
const translations = await import(`../public/locales/${locale}.json`);
return translations.default;
}
Übergebe sie dann an deine <GTProvider>
Komponente:
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 vongt-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 mitloadTranslations()
geladen werden.
Nächste Schritte
- Wenn Sie eigene Übersetzungen schreiben möchten, sehen Sie sich benutzerdefinierte Übersetzungen an.
- Weitere Informationen zum Schreiben eines eigenen Übersetzungs-Loaders finden Sie unter
loadTranslations()
.
Wie ist dieser Leitfaden?