Aperçu

La méthode getLocaleName récupère le nom d’affichage d’un code de locale à l’aide de l’API Intl.DisplayNames. Elle renvoie un nom lisible par l’humain pour tout code de locale BCP‑47 valide, localisé selon la locale source de l’instance.

const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es'
});

const name = gt.getLocaleName('fr-CA');
console.log(name); // "français (Canada)"

Références

Paramètres

Description des paramètres

Renvoie

string - Le nom d’affichage localisé de la locale.

Lève

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

Fonctionnement

Langue d’affichage

Le nom d’affichage est localisé selon :

1. Le sourceLocale de l’instance (si configuré)
2. La locale par défaut de la bibliothèque (« en »)

Intégration de mappage personnalisé

• Les mappages de locale personnalisés sont vérifiés en premier
• Si un name personnalisé est défini, il est prioritaire
• À défaut, utilisation de Intl.DisplayNames pour les codes BCP-47 standard

Exemples

const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'fr'
});

// Obtenir le nom de la localeCible
console.log(gt.getLocaleName()); // "French (France)"

// Obtenir les noms d'autres locales
console.log(gt.getLocaleName('es')); // "Spanish (Spain)"
console.log(gt.getLocaleName('de')); // "German (Germany)"
console.log(gt.getLocaleName('ja')); // "Japanese (Japan)"

Notes

• La méthode utilise le sourceLocale de l’instance pour déterminer la langue d’affichage
• Les noms d’association personnalisés priment sur les Intl.DisplayNames standard

Prochaines étapes

• Récupérez l’emoji du locale avec getLocaleEmoji
• Récupérez des informations complètes sur le locale avec getLocaleProperties
• Découvrez le type CustomMapping