Aperçu

La méthode determineLocale sélectionne la locale la plus pertinente à partir d’une liste de locales approuvées, selon les préférences de l’utilisateur. Elle effectue une négociation de locale pour identifier la locale la plus adaptée lorsqu’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'

// Locale de secours
console.log(gt.determineLocale('en-GB')); // 'en-US' (variante anglaise 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 - T locale la plus appropriée, ou undefined si aucune correspondance n’est trouvée

Exemples

Négociation du locale de l’utilisateur

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

// Simuler 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' selon l'ordre de préférence

Notes

• Renvoie la première correspondance exacte parmi les locales approuvées
• Se rabat sur des correspondances de 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 implémenter 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