loadDictionary
API-Referenz für die Funktion loadDictionary().
Übersicht
loadDictionary lädt eine JSON-Übersetzungsdatei 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 vor allem verwendet, um bestehende i18n‑Projekte zu General Translation zu migrieren, wobei die vorhandenen Übersetzungen erhalten bleiben.
Wenn mehrere Übersetzungen vorhanden sind, haben Übersetzungen aus Wörterbüchern, die von loadDictionary geladen wurden, stets Vorrang vor anderen.
loadDictionary unterstützt nur die Verwendung von JSON files mit Zeichenkettenübersetzungen.
Referenz
Parameter
Prop
Type
Beschreibung
| Typ | Beschreibung |
|---|---|
locale | Das Locale, für das Übersetzungen geladen werden sollen. |
Rückgabewert
Ein Promise<any>, das zu einem Wörterbuch aufgelöst wird, das id den Übersetzungen für die angegebene locale zuordnet.
Setup
In der Regel laden Sie das Wörterbuch aus dem Verzeichnis ./public/locales.
Definieren Sie Ihr loadDictionary in einer Datei.
Stellen Sie sicher, dass die Funktion ein Promise zurückgibt, das zu einem Objekt mit Übersetzungen für das angegebene locale aufgelöst wird.
export default async function loadDictionary(locale) {
const translations = await import(`../public/locales/${locale}.json`);
return translations.default;
}Übergeben Sie es anschließend an Ihre <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?
loadTranslationswird verwendet, um benutzerdefiniertes Ladeverhalten für das Abrufen von Übersetzungen für Ihre App zu definieren. Das kann das Beziehen von Übersetzungen über ein CDN (Content Delivery Network), eine Datenbank oder das Bundle Ihrer App sein. Dabei handelt es sich in der Regel um maschinell erzeugte Übersetzungen, die vom CLI-Tool (Kommandozeilenschnittstelle) verwaltet werden und nicht besonders benutzerfreundlich zu bearbeiten sind.loadDictionaryist für Implementierungen vongt-reactals eigenständige Bibliothek gedacht. Nutzer bringen ihre eigenen Übersetzungen mit, und es wird keine Übersetzungsinfrastruktur verwendet.
Hinweise
loadDictionarywird verwendet, um benutzerdefinierte Übersetzungen für deine App zu laden.- Von
loadDictionarygeladene Wörterbücher haben Vorrang vor Übersetzungen, die vonloadTranslationsgeladen werden.
Nächste Schritte
- Wenn Sie eigene Übersetzungen schreiben möchten, sehen Sie sich benutzerdefinierte Übersetzungen an.
- Weitere Informationen zum Erstellen eines benutzerdefinierten Translation-Loaders finden Sie unter
loadTranslations.
Wie ist diese Anleitung?