Présentation

La méthode requiresTranslation détermine si une traduction est nécessaire en fonction des locales source et cible. Elle vérifie si le contenu source doit être traduit en comparant les codes de locale et en tenant compte de la liste des locales approuvées.

Référence

Paramètres

Description des paramètres

Renvoie

boolean - true si une traduction est nécessaire, false sinon

Lève

• Error - Si aucune locale source n’est fournie et que l’instance n’a pas de sourceLocale configuré
• Error - Si aucune locale cible n’est fournie et que l’instance n’a pas de targetLocale configuré

Exemples

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

// Des langues différentes nécessitent une traduction
console.log(gt.requiresTranslation('en-US', 'es-ES')); // true
console.log(gt.requiresTranslation('en-US', 'fr-FR')); // true

// Une même langue ne nécessite pas de traduction
console.log(gt.requiresTranslation('en-US', 'en-US')); // false
console.log(gt.requiresTranslation('es-ES', 'es-ES')); // false

// Différents dialectes d'une même langue ne nécessitent pas de traduction
console.log(gt.requiresTranslation('en-US', 'en-GB')); // false
console.log(gt.requiresTranslation('es-ES', 'es-MX')); // false

// Cible absente des locales approuvés
console.log(gt.requiresTranslation('en-US', 'it-IT')); // false (it-IT absent des locales approuvés)

Notes

• Prend en compte les familles de langues des locales, pas uniquement les correspondances exactes
• Respecte les listes de locales approuvées
• Renvoie false lorsque la locale cible ne figure pas dans les locales approuvées (si fournies)

Prochaines étapes

• Vérifier les relations entre locales avec isSameLanguage
• Déterminer la meilleure locale avec determineLocale
• Valider les locales avec isValidLocale