Uso de diccionarios

¿Qué son los diccionarios?

Los diccionarios son archivos de traducción tradicionales de clave-valor. Son útiles para:

• Cadenas compartidas entre muchos componentes (etiquetas de botones, mensajes de error)
• Contenido gestionado fuera de tu base de código
• Migración desde configuraciones i18n existentes

Configuración

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

Crear un diccionario

src/dictionaries/common.json

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

useDictionary(filenameKey) busca un archivo de diccionario y devuelve un Record<string, string>. La clave del nombre de archivo es la ruta del diccionario sin la extensión .json:

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

Uso en componentes

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

Si ninguna entrada coincide con la clave del nombre de archivo, useDictionary(filenameKey) devuelve un objeto vacío.