Übersicht

Die Methode getLocaleEmoji ermittelt basierend auf der Region eines locale code ein Flaggen‑Emoji oder Symbol. Sie gibt passende Flaggen‑Emojis für Länder und Territorien zurück, nutzt Standardwerte für Sprachen ohne spezifische Regionen und unterstützt benutzerdefinierte Emojis über Zuordnungen.

const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'fr-CA'
});

const emoji = gt.getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (Kanadische Flagge)

const usEmoji = gt.getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (US-Flagge)

const enEmoji = gt.getLocaleEmoji('en');
console.log(enEmoji); // "🇺🇸" (US-Flagge)

Referenzen

Parameter

Parameterbeschreibung

Rückgabewert

string - Emoji-Flagge oder Symbol, das die locale repräsentiert:

• Länder-/Gebietsflaggen-Emoji für locales mit Regionen (z. B. 🇺🇸, 🇫🇷, 🇯🇵)
• Sprachspezifisches Emoji für einige Sprachen ohne Regionen
• Standard-Flaggen-Emoji (🏳️) für nicht erkannte locales

Löst aus

• Error – wenn keine locale angegeben ist und für die Instanz keine targetLocale konfiguriert ist

Beispiele

const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es'
});

// Emoji für Ziel-Locale abrufen
console.log(gt.getLocaleEmoji()); // "🇪🇸" (verwendet targetLocale 'es')

// Emojis für verschiedene Locales abrufen
console.log(gt.getLocaleEmoji('en-US')); // "🇺🇸"
console.log(gt.getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(gt.getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(gt.getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(gt.getLocaleEmoji('zh-CN')); // "🇨🇳"

Hinweise

• Gibt Flaggen-Emojis basierend auf dem Regionscode der locale zurück, wenn verfügbar
• Benutzerdefinierte Emoji-Zuordnungen haben Vorrang vor der regionsbasierten Auswahl
• Verwendet Unicode-Regionalindikator-Symbole zur Flaggen­generierung
• Fällt auf 🏳️ (weiße Flagge) zurück bei nicht erkannten oder ungültigen locales
• Kompatibel mit allen modernen Browsern und Betriebssystemen, die Unicode-Emojis unterstützen

Nächste Schritte

• Rufen Sie Locale-Eigenschaften mit getLocaleProperties ab
• Rufen Sie Locale-Namen mit getLocaleName ab
• Validieren Sie Locales mit isValidLocale
• Erfahren Sie mehr über den Typ CustomMapping