Utility FunctionsLocales

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ètreDescription
localecode de locale BCP-47 pour lequel récupérer des emoji
customMappingMappage 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

Comment trouvez-vous ce guide ?