Utility FunctionsLocales

getLocaleEmoji

Riferimento API per la funzione standalone getLocaleEmoji

Panoramica

La funzione standalone getLocaleEmoji recupera la bandiera o un simbolo emoji per un codice locale senza richiedere un’istanza della classe GT. Restituisce le emoji di bandiera appropriate per paesi e territori in base alla regione del locale, con supporto per mappature di emoji personalizzate.

import { getLocaleEmoji } from 'generaltranslation';

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

const usEmoji = getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (bandiera degli Stati Uniti)

Riferimenti

Parametri

Prop

Type

Descrizione dei parametri

ParametroDescrizione
localeCodice locale BCP‑47 per il quale ottenere l’emoji
customMappingMappatura personalizzata opzionale per codici locale e sostituzioni delle emoji

Restituisce

string - Emoji di bandiera o simbolo che rappresenta la locale:

  • Emoji della bandiera nazionale/territoriale per le locali con regione (es., 🇺🇸, 🇫🇷, 🇯🇵)
  • Emoji personalizzata se definita nella mappatura
  • Emoji di bandiera predefinita (🏳️) per locali non riconosciute

Esempi

Recupero di base delle emoji

import { getLocaleEmoji } from 'generaltranslation';

// Bandiere dei paesi più comuni
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')); // "🇨🇳"

// Regioni multilingue
console.log(getLocaleEmoji('en-CA')); // "🇨🇦"
console.log(getLocaleEmoji('fr-CA')); // "🇨🇦"
console.log(getLocaleEmoji('de-CH')); // "🇨🇭"
console.log(getLocaleEmoji('fr-CH')); // "🇨🇭"

Note

  • Restituisce le emoji delle bandiere usando i simboli Unicode “Regional Indicator”
  • Le mappature personalizzate delle emoji hanno la precedenza rispetto alla selezione basata sulla regione
  • Supporta tutti i codici di regione ISO 3166-1 alpha-2 per una copertura completa

Prossimi passi

Come valuti questa guida?

getLocaleEmoji