Utility FunctionsLocales

getLocaleEmoji

Référence de l’API pour la fonction indépendante getLocaleEmoji

Vue d’ensemble

La fonction autonome getLocaleEmoji récupère un drapeau ou un symbole emoji pour un code de locale sans nécessiter d’instance de la classe GT. Elle renvoie les emoji de drapeaux appropriés pour les pays et territoires en fonction de la région de la locale, avec prise en charge de mappages personnalisés d’emoji.

import { getLocaleEmoji } from 'generaltranslation';

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

const usEmoji = getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (drapeau des États-Unis)

Références

Paramètres

Prop

Type

Description des paramètres

ParamètreDescription
localeCode de locale BCP-47 pour obtenir l’emoji correspondant
customMappingMappage personnalisé optionnel pour les codes de locale et les substitutions d’emoji

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 personnalisé s’il est 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 nationaux 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')); // "🇨🇭"

Notes

  • Renvoie des emojis de drapeaux via les symboles d’indicateurs régionaux Unicode
  • Les correspondances d’emojis personnalisées priment sur la sélection basée sur la région
  • Prend en charge tous les codes régionaux ISO 3166-1 alpha-2 pour une couverture exhaustive

Prochaines étapes

Que pensez-vous de ce guide ?

getLocaleEmoji