Dictionaries verwenden

Was sind Dictionaries?

Dictionaries sind klassische Schlüssel-Wert-Übersetzungsdateien. Sie sind nützlich für:

• Gemeinsam genutzte Strings über viele Komponenten hinweg (Button-Beschriftungen, Fehlermeldungen)
• Inhalte, die außerhalb deiner Codebasis verwaltet werden
• Migration aus bestehenden i18n-Setups

Konfiguration

{
  "dictionaries": {
    "include": ["src/dictionaries/*.json"],
    "format": "key-value"
  }
}

Ein Dictionary erstellen

src/dictionaries/common.json

{
  "save": "Save",
  "cancel": "Cancel",
  "delete": "Delete",
  "loading": "Loading..."
}

useDictionary(filenameKey) sucht eine Dictionary-Datei und gibt ein Record<string, string> zurück. Der Dateiname-Schlüssel ist der Dictionary-Pfad ohne die .json-Erweiterung:

• src/dictionaries/common.json → common
• src/dictionaries/pages/home.json → pages/home

In Komponenten verwenden

import { useDictionary } from 'tyndale-react';

export function ActionButtons() {
  const labels = useDictionary('common');

  return (
    <div>
      <button>{labels.save ?? 'Save'}</button>
      <button>{labels.cancel ?? 'Cancel'}</button>
    </div>
  );
}

Wenn keine Einträge zum Dateiname-Schlüssel passen, gibt useDictionary(filenameKey) ein leeres Objekt zurück.