Config

loadDictionary

Referencia de API de la función loadDictionary().

Descripción general

loadDictionary cargará un archivo JSON de traducción para un locale dado.

Esta función está pensada para quienes desean usar gt-next como una biblioteca de i18n independiente.

Esta función se utiliza principalmente para migrar proyectos existentes con i18n a General Translation manteniendo sus traducciones actuales. Sigue esta guía para configurarlo.

Si existen varias traducciones, las de los dictionaries cargados por loadDictionary siempre tendrán prioridad sobre las demás. loadDictionary solo admite archivos JSON con traducciones de tipo string.

Referencias

Parámetros

Prop

Type

Descripción

TipoDescripción
localeEl locale para el cual se deben cargar las traducciones.

Retorna

Un Promise<any> que se resuelve en un diccionario que asigna ids a traducciones para la locale dada.


Configuración

Por lo general, cargarás el diccionario desde el directorio ./public/locales.

Define loadDictionary como la exportación predeterminada de un archivo con el nombre loadDictionary.js o loadDictionary.ts, ya sea en el directorio src/ o en la raíz. Asegúrate de que la función devuelva una promesa que se resuelva en un objeto con las traducciones para el locale indicado.

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

Pregunta: ¿Cuál es la diferencia entre loadTranslations y loadDictionary?

  • loadTranslations se usa para definir un comportamiento de carga personalizado para obtener las traducciones de tu app. Esto puede implicar obtener traducciones desde un CDN (Content Delivery Network), una base de datos o el bundle de tu app. Suelen ser traducciones generadas automáticamente, gestionadas por la herramienta de la CLI, y no son muy amigables para editar.
  • loadDictionary está pensado para implementaciones de gt-next como biblioteca independiente. Los usuarios aportan sus propias traducciones y no se usa infraestructura de traducción.

Notas

  • loadDictionary se utiliza para cargar traducciones personalizadas para tu app.
  • Los dictionaries cargados por loadDictionary tendrán prioridad sobre las traducciones cargadas por loadTranslations.

Próximos pasos

¿Qué te ha parecido esta guía?

loadDictionary