GT ClassMethodsLocales

getLocaleEmoji

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

Aperçu

La méthode getLocaleEmoji récupère un drapeau ou symbole emoji pour un code de locale en fonction de sa région. Elle renvoie des emojis de drapeaux appropriés pour les pays et territoires, avec des mécanismes de secours pour les langues sans région spécifique, ainsi qu’une prise en charge d’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 le 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égion (p. ex. : 🇺🇸, 🇫🇷, 🇯🇵)
  • Emoji propre à certaines langues sans région
  • Emoji de drapeau par défaut (🏳️) pour les locales non reconnues

Exceptions

  • Error - Si aucune locale n’est fournie et qu’aucune targetLocale n’est configurée pour l’instance

Exemples

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

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

// Obtenir les emojis pour différentes 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 lorsqu’il est disponible
  • 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 🏳️ (drapeau blanc) par défaut 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

Que pensez-vous de ce guide ?

getLocaleEmoji