GT ClassMethodsLocales

getLocaleEmoji

Référence de l’API pour la méthode getLocaleEmoji de GT

Aperçu

La méthode getLocaleEmoji renvoie un drapeau ou un symbole emoji pour un code de locale en fonction de sa région. Elle retourne les emojis de drapeau appropriés pour les pays et territoires, avec des secours pour les langues sans région spécifique, et prend en charge des emojis personnalisés via des correspondances.

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

const emoji = gt.getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (drapeau canadien)

const usEmoji = gt.getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (drapeau américain)

const enEmoji = gt.getLocaleEmoji('en');
console.log(enEmoji); // "🇺🇸" (drapeau américain)

Références

Paramètres

Prop

Type

Description des paramètres

ParamètreDescription
localeCode de locale BCP‑47 pour lequel récupérer l’emoji. S’il n’est pas fourni, utilise la targetLocale de l’instance

Renvoie

string - Emoji de drapeau ou symbole représentant le locale :

  • Emoji de drapeau de pays/territoire pour les locales avec régions (p. ex. : 🇺🇸, 🇫🇷, 🇯🇵)
  • Emoji propre à la langue pour certaines langues sans régions
  • Emoji de drapeau par défaut (🏳️) pour les locales non reconnues

Exceptions levées

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

Exemples

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

// Obtenir l'emoji pour la localeCible
console.log(gt.getLocaleEmoji()); // "🇪🇸" (utilise localeCible 'es')

// Obtenir les emojis pour différents locales
console.log(gt.getLocaleEmoji('en-US')); // "🇺🇸"
console.log(gt.getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(gt.getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(gt.getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(gt.getLocaleEmoji('zh-CN')); // "🇨🇳"

Notes

  • Renvoie des emoji de drapeau en fonction du code de région du locale lorsque c’est possible
  • Les mappages d’emoji personnalisés priment sur la sélection basée sur la région
  • Utilise les symboles indicateurs régionaux Unicode pour générer les drapeaux
  • Utilise par défaut 🏳️ (drapeau blanc) pour les locales non reconnues ou invalides
  • Compatible avec tous les navigateurs modernes et systèmes d’exploitation prenant en charge les emoji Unicode

Prochaines étapes

Comment trouvez-vous ce guide ?