Config

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

TypBeschreibung
localeDie 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.

src/loadDictionary.js
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?

  • loadTranslations wird 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.
  • loadDictionary ist für Implementierungen von gt-next als eigenständige Bibliothek gedacht. Nutzer bringen ihre eigenen Übersetzungen mit, und es wird keine Übersetzungsinfrastruktur verwendet.

Hinweise

  • loadDictionary wird verwendet, um eigene Übersetzungen für Ihre App zu laden.
  • Von loadDictionary geladene Wörterbücher haben Vorrang vor Übersetzungen, die über loadTranslations geladen werden.

Nächste Schritte

Wie ist diese Anleitung?