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
| Parametro | Descrizione |
|---|---|
locale | Codice locale BCP‑47 per il quale ottenere l’emoji |
customMapping | Mappatura 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
- Usa il metodo di classe di GT
getLocaleEmoji - Ottieni le proprietà della locale con
getLocaleProperties - Ottieni i nomi delle locale con
getLocaleName - Convalida le locale con
isValidLocale
Come valuti questa guida?