Vue d’ensemble

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érences

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ées
console.log(gt.requiresTranslation('en-US', 'it-IT')); // false (it-IT absent des locales approuvées)

Notes

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

Prochaines étapes

• Vérifiez les relations entre locales avec isSameLanguage
• Déterminez la locale la plus adaptée avec determineLocale
• Validez les locales avec isValidLocale