loadDictionary()

Überblick

loadDictionary() lädt eine Übersetzungs-JSON-Datei für eine gegebene 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 zu General Translation zu migrieren, während ihre bestehenden Übersetzungen beibehalten werden.

Wenn mehrere Übersetzungen existieren, haben Übersetzungen aus Wörterbüchern, die von 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ückgabewerte

Ein Promise<any>, das zu einem Wörterbuch aufgelöst wird, das IDs den Übersetzungen für das gegebene Gebietsschema zuordnet.

Einrichtung

Im Allgemeinen laden Sie das Wörterbuch aus dem Verzeichnis ./public/locales.

Definieren Sie Ihre loadDictionary() in einer Datei. Stellen Sie sicher, dass die Funktion ein Versprechen zurückgibt, das zu einem Objekt mit Übersetzungen für die gegebene Sprache aufgelöst wird.

src/loadDictionary.js

export default async function loadDictionary(locale) {
  const translations = await import(`../public/locales/${locale}.json`);
  return translations.default;
}

Dann übergeben Sie es 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. Dies könnte das Abrufen von Übersetzungen von einem CDN, einer Datenbank oder dem Bundle Ihrer App sein. Diese sind normalerweise maschinell generierte Übersetzungen, die vom CLI-Tool verwaltet werden und nicht sehr benutzerfreundlich zu bearbeiten sind.
loadDictionary() ist für Implementierungen von gt-react als eigenständige Bibliothek gedacht. Benutzer bringen ihre eigenen Übersetzungen mit und es wird keine Übersetzungsinfrastruktur verwendet.

Notizen

loadDictionary() wird verwendet, um benutzerdefinierte Übersetzungen für Ihre App zu laden.
Wörterbücher, die von loadDictionary() geladen werden, haben Vorrang vor Übersetzungen, die von loadTranslations() geladen werden.

Nächste Schritte

Wenn Sie Ihre eigenen Übersetzungen schreiben möchten, schauen Sie sich benutzerdefinierte Übersetzungen an.
Siehe loadTranslations() für weitere Informationen zum Schreiben eines benutzerdefinierten Übersetzungs-Laders.

loadDictionary()

Auf dieser Seite