GT ClassMethodsLocales

requiresTranslation

Referencia de API del método requiresTranslation de GT

Descripción general

El método requiresTranslation determina si se necesita traducción según las locales de origen y destino. Comprueba si el contenido de origen debe traducirse comparando los códigos de configuración regional y teniendo en cuenta la lista de locales aprobadas.


Referencias

Parámetros

Prop

Type

Descripción de parámetros

ParámetroDescripción
sourceLocaleCódigo de configuración regional de origen. Si no se proporciona, utiliza el sourceLocale de la instancia
targetLocaleCódigo de configuración regional de destino. Si no se proporciona, utiliza el targetLocale de la instancia
approvedLocalesLista de configuraciones regionales de destino aprobadas. Si no se proporciona, utiliza la lista locales de la instancia
customMappingAsignación personalizada opcional para la resolución de la configuración regional

Devuelve

boolean - true si se requiere traducción; false en caso contrario

Excepciones

  • Error - Si no se proporciona un locale de origen y la instancia no tiene sourceLocale configurado
  • Error - Si no se proporciona un locale de destino y la instancia no tiene targetLocale configurado

Ejemplos

const gt = new GT({
  sourceLocale: 'en-US',
  targetLocale: 'es-ES',
  locales: ['en-US', 'es-ES', 'fr-FR', 'de-DE']
});

// Idiomas diferentes requieren traducción
console.log(gt.requiresTranslation('en-US', 'es-ES')); // true
console.log(gt.requiresTranslation('en-US', 'fr-FR')); // true

// El mismo idioma no requiere traducción
console.log(gt.requiresTranslation('en-US', 'en-US')); // false
console.log(gt.requiresTranslation('es-ES', 'es-ES')); // false

// Diferentes dialectos del mismo idioma no requieren traducción
console.log(gt.requiresTranslation('en-US', 'en-GB')); // false
console.log(gt.requiresTranslation('es-ES', 'es-MX')); // false

// El destino no está en los locales aprobados
console.log(gt.requiresTranslation('en-US', 'it-IT')); // false (it-IT no está en los locales aprobados)

Notas

  • Tiene en cuenta las familias de idioma del locale, no solo las coincidencias exactas
  • Respeta las listas de locales aprobados
  • Devuelve false cuando el locale de destino no está en los locales aprobados (si se proporcionan)

Próximos pasos

¿Qué te parece esta guía?