Config

loadDictionary()

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

Resumen

loadDictionary() cargará un archivo json de traducción para una localidad dada.

Esta función está destinada a aquellos que desean usar gt-next como una biblioteca i18n independiente.

Esta función se utiliza principalmente para migrar proyectos existentes con i18n a Traducción General mientras mantienen sus traducciones existentes. Siga esta guía para configurarlo.

Si existen múltiples traducciones, las traducciones de los diccionarios cargados por loadDictionary() siempre tendrán prioridad sobre otras. loadDictionary() solo admite el uso de archivos JSON con traducciones de cadenas.

Referencia

Parámetros

PropTypeDefault
locale?
string
-

Descripción

TipoDescripción
localeLa configuración regional para la cual se deben cargar las traducciones.

Retornos

Un Promise<any> que se resuelve en un diccionario que mapea ids a traducciones para la configuración regional dada.


Configuración

Generalmente, cargarás el diccionario desde el directorio ./public/locales.

Define tu loadDictionary() como la exportación por defecto para 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 traducciones para la localidad dada.

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 utiliza para definir un comportamiento de carga personalizado para obtener traducciones para tu aplicación. Esto podría ser obtener traducciones desde un CDN, una base de datos, o el paquete de tu aplicación. Estas suelen ser traducciones generadas por máquina, gestionadas por la herramienta cli, y no son muy amigables para editar.
  • loadDictionary() está destinado para implementaciones de gt-next como una biblioteca independiente. Los usuarios traen sus propias traducciones y no se utiliza ninguna infraestructura de traducción.

Notas

  • loadDictionary() se utiliza para cargar traducciones personalizadas para tu aplicación.
  • Los diccionarios cargados por loadDictionary() tendrán prioridad sobre las traducciones cargadas por loadTranslations().

Próximos pasos

En esta página