Uso dei dizionari

Cosa sono i dizionari?

I dizionari sono file di traduzione tradizionali chiave-valore. Sono utili per:

• Stringhe condivise tra molti componenti (etichette dei pulsanti, messaggi di errore)
• Contenuti gestiti al di fuori della tua codebase
• Migrazione da configurazioni i18n esistenti

Configurazione

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

Crea un dizionario

src/dictionaries/common.json

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

useDictionary(filenameKey) cerca in un singolo file di dizionario e restituisce un Record<string, string>. La chiave del nome file è il percorso del dizionario senza l’estensione .json:

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

Uso nei componenti

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>
  );
}

Se nessuna voce corrisponde alla chiave del nome file, useDictionary(filenameKey) restituisce un oggetto vuoto.