loadDictionary
API-Referenz für die Funktion loadDictionary().
Übersicht
loadDictionary lädt eine Übersetzungs‑JSON‑Datei für eine angegebene locale.
Diese Funktion richtet sich an alle, die gt-next als eigenständige i18n‑Bibliothek verwenden möchten.
Sie wird vor allem genutzt, um bestehende i18n‑Projekte zu General Translation zu migrieren und dabei ihre vorhandenen Übersetzungen beizubehalten. Folgen Sie diesem Leitfaden, um dies einzurichten.
Wenn mehrere Übersetzungen vorhanden sind, haben Übersetzungen aus Wörterbüchern, die von loadDictionary geladen werden, stets Vorrang vor anderen.
loadDictionary unterstützt nur die Verwendung von JSON files mit Zeichenkettenübersetzungen.
Referenzen
Parameter
Prop
Type
Beschreibung
| Typ | Beschreibung |
|---|---|
locale | Die Locale, für die Ü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.
Einrichtung
In der Regel laden Sie das Wörterbuch aus dem Verzeichnis ./public/locales.
Definieren Sie loadDictionary als Standardexport für eine Datei mit dem Namen loadDictionary.js oder loadDictionary.ts, entweder im Verzeichnis src/ oder im Projektstamm.
Stellen Sie sicher, dass die Funktion ein Promise zurückgibt, das zu einem Objekt mit Übersetzungen für die angegebene locale aufgelöst wird.
export default async function loadDictionary(locale) {
const translations = await import(`../public/locales/${locale}.json`);
return translations.default;
}Frage: Was ist der Unterschied zwischen loadTranslations und loadDictionary?
loadTranslationswird verwendet, um benutzerdefiniertes Ladeverhalten für das Abrufen von Übersetzungen in Ihrer App zu definieren. Das kann das Laden von Übersetzungen über ein CDN (Content Delivery Network), aus einer Datenbank oder aus dem Bundle Ihrer App umfassen. Dabei handelt es sich in der Regel um maschinell erzeugte Übersetzungen, die vom CLI-Tool (Command-Line Interface) verwaltet werden und sich nicht besonders benutzerfreundlich bearbeiten lassen.loadDictionaryist für Implementierungen vongt-nextals eigenständige Bibliothek gedacht. Nutzer bringen ihre eigenen Übersetzungen mit, und es wird keine Übersetzungsinfrastruktur verwendet.
Hinweise
loadDictionarywird verwendet, um eigene Übersetzungen für Ihre App zu laden.- Von
loadDictionarygeladene Wörterbücher haben Vorrang vor Übersetzungen, die überloadTranslationsgeladen werden.
Nächste Schritte
- Wenn Sie eigene Übersetzungen verfassen möchten, sehen Sie sich die benutzerdefinierten Übersetzungen an.
- Weitere Informationen zum Schreiben eines benutzerdefinierten Übersetzungsloaders finden Sie unter
loadTranslations.
Wie ist diese Anleitung?