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ámetro | Descripción |
|---|---|
sourceLocale | Código de configuración regional de origen. Si no se proporciona, utiliza el sourceLocale de la instancia |
targetLocale | Código de configuración regional de destino. Si no se proporciona, utiliza el targetLocale de la instancia |
approvedLocales | Lista de configuraciones regionales de destino aprobadas. Si no se proporciona, utiliza la lista locales de la instancia |
customMapping | Asignació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 tienesourceLocaleconfiguradoError- Si no se proporciona un locale de destino y la instancia no tienetargetLocaleconfigurado
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
falsecuando el locale de destino no está en los locales aprobados (si se proporcionan)
Próximos pasos
- Comprueba las relaciones de locale con
isSameLanguage - Determina el mejor locale con
determineLocale - Valida los locales con
isValidLocale
¿Qué te parece esta guía?