Config

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

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

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

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

Hinweise

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

Nächste Schritte

Wie ist diese Anleitung?