getLocaleEmoji
Référence de l’API pour la fonction autonome getLocaleEmoji
Vue d’ensemble
La fonction autonome getLocaleEmoji renvoie un drapeau (emoji) ou un symbole pour un code de locale sans nécessiter d’instance de GT.
Elle fournit des drapeaux emoji appropriés pour les pays et territoires selon la région de la locale, avec prise en charge de correspondances d’emoji personnalisées.
import { getLocaleEmoji } from 'generaltranslation';
const emoji = getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (drapeau canadien)
const usEmoji = getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (drapeau américain)Références
Paramètres
Prop
Type
Description des paramètres
| Paramètre | Description |
|---|---|
locale | code de locale BCP-47 pour lequel récupérer des emoji |
customMapping | Mappage personnalisé facultatif pour les codes de locale et les remplacements d’emoji |
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 personnalisé si défini dans le mapping
- Emoji de drapeau par défaut (
🏳️) pour les locales non reconnues
Exemples
Récupération d’emojis de base
import { getLocaleEmoji } from 'generaltranslation';
// Drapeaux de pays courants
console.log(getLocaleEmoji('en-US')); // "🇺🇸"
console.log(getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(getLocaleEmoji('zh-CN')); // "🇨🇳"
// Régions multilingues
console.log(getLocaleEmoji('en-CA')); // "🇨🇦"
console.log(getLocaleEmoji('fr-CA')); // "🇨🇦"
console.log(getLocaleEmoji('de-CH')); // "🇨🇭"
console.log(getLocaleEmoji('fr-CH')); // "🇨🇭"Remarques
- Renvoie des emoji de drapeaux à l’aide des symboles Unicode d’indicateurs régionaux
- Les correspondances d’emoji personnalisées ont priorité sur la sélection basée sur la région
- Prend en charge tous les codes de région ISO 3166-1 alpha-2 pour une couverture exhaustive
Prochaines étapes
- Utilisez la méthode de la GT class
getLocaleEmoji - Récupérez les propriétés d’un locale avec
getLocaleProperties - Récupérez les noms de locale avec
getLocaleName - Validez les locales avec
isValidLocale
Comment trouvez-vous ce guide ?