Présentation

La méthode determineLocale identifie la meilleure locale correspondante à partir d’une liste de locales approuvées, en fonction des préférences de l’utilisateur. Elle effectue une négociation de locale pour déterminer la locale la plus adaptée lorsque qu’aucune correspondance exacte n’est disponible.

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

// Correspondance exacte
console.log(gt.determineLocale('en-US')); // 'en-US'

// Secours au niveau de la langue
console.log(gt.determineLocale('en-GB')); // 'en-US' (variante d’anglais la plus proche)

// Préférences multiples
console.log(gt.determineLocale(['fr-CA', 'es-MX', 'en-US'])); // 'es-ES' (espagnol le plus proche)

// Aucune correspondance
console.log(gt.determineLocale('it-IT')); // undefined

Références

Paramètres

Renvoie

string | undefined — Meilleure locale correspondante ou undefined si aucune correspondance n’est trouvée

Exemples

Négociation de la locale de l’utilisateur

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

// Simule l’en-tête Accept-Language du navigateur
const userPreferences = ['fr-CA', 'en-GB', 'en'];
const bestMatch = gt.determineLocale(userPreferences);
console.log(bestMatch); // 'fr-FR' d’après l’ordre de préférence

Notes

• Renvoie la première correspondance exacte parmi les locales approuvées
• Bascule vers une correspondance par langue lorsque la région exacte n’est pas disponible
• Respecte l’ordre de préférence dans le tableau d’entrée
• Renvoie undefined lorsqu’aucune correspondance adéquate n’est trouvée
• Indispensable pour mettre en œuvre la négociation de locale dans les applications web

Prochaines étapes

• Vérifiez les besoins de traduction avec requires-translation
• Comparez les langues avec is-same-language