GT ClassMethodsLocales
requiresTranslation
Referencia de API del método requiresTranslation de GT
Descripción general
El método requiresTranslation determina si es necesaria una traducción según las locales de origen y destino.
Comprueba si el contenido de origen debe traducirse comparando los códigos de locale 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, se usa el sourceLocale de la instancia |
targetLocale | Código de configuración regional de destino. Si no se proporciona, se usa el targetLocale de la instancia |
approvedLocales | Lista de locales de destino aprobados. Si no se proporciona, se usa la lista locales de la instancia |
customMapping | Mapeo personalizado opcional para la resolución de locales |
Devuelve
boolean - true si se requiere traducción, false en caso contrario
Excepciones
Error- Si no se proporciona ninguna fuente y la instancia no tienesourceLocaleconfiguradoError- Si no se proporciona ningún 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
- Considera familias de idiomas por locale, no solo coincidencias exactas
- Respeta las listas de locales aprobados
- Devuelve
falsecuando el locale de destino no está en los locales aprobados (si se proporciona)
Próximos pasos
- Verifica las relaciones entre locales con
isSameLanguage - Determina el mejor locale con
determineLocale - Valida los locales con
isValidLocale
¿Qué te ha parecido esta guía?