loadDictionary()

Descripción general

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

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

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

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

Referencia

Parámetros

Prop	Type	Default
`locale?`	`string`	-

Descripción

Tipo	Descripción
`locale`	El 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 el locale dado.

Configuración

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

Define tu loadDictionary() como la exportación por defecto 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 retorne una promesa que resuelva a un objeto con las 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. Normalmente, estas son traducciones generadas por máquina, gestionadas por la herramienta cli, y no son muy fáciles de editar para los usuarios.
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

Si deseas escribir tus propias traducciones, consulta traducciones personalizadas.
Consulta loadTranslations() para obtener más información sobre cómo escribir un cargador de traducciones personalizado.

loadDictionary()

En esta página