Utility FunctionsLocales

getLocaleEmoji

API Reference für die eigenständige Funktion getLocaleEmoji

Übersicht

Die eigenständige Funktion getLocaleEmoji liefert ein Flaggen- oder Regionssymbol (Emoji) zu einem locale code, ohne dass eine Instanz der GT-Klasse erforderlich ist. Sie gibt je nach Regionsangabe der locale passende Flaggen-Emojis für Länder und Gebiete zurück und unterstützt benutzerdefinierte Emoji-Zuordnungen.

import { getLocaleEmoji } from 'generaltranslation';

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

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

Referenzen

Parameter

Prop

Type

Parameterbeschreibung

ParameterBeschreibung
localeBCP‑47-Locale-Code, für den das Emoji ermittelt wird
customMappingOptionale benutzerdefinierte Zuordnung für Locale-Codes und Emoji-Overrides

Rückgabe

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

  • Länder-/Gebietsflaggen-Emoji für locales mit Regionen (z. B. 🇺🇸, 🇫🇷, 🇯🇵)
  • Benutzerdefiniertes Emoji, wenn in der Zuordnung definiert
  • Standard-Flaggen-Emoji (🏳️) für nicht erkannte locales

Beispiele

Einfaches Abrufen von Emojis

import { getLocaleEmoji } from 'generaltranslation';

// Häufig verwendete Länderflaggen
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')); // "🇨🇳"

// Regionen mit mehreren Amtssprachen
console.log(getLocaleEmoji('en-CA')); // "🇨🇦"
console.log(getLocaleEmoji('fr-CA')); // "🇨🇦"
console.log(getLocaleEmoji('de-CH')); // "🇨🇭"
console.log(getLocaleEmoji('fr-CH')); // "🇨🇭"

Hinweise

  • Gibt Flaggen-Emojis mithilfe der Unicode-Regionalindikatorzeichen zurück
  • Benutzerdefinierte Emoji-Zuordnungen haben Vorrang vor der regionsbasierten Auswahl
  • Unterstützt alle ISO-3166-1-Alpha-2-Ländercodes für eine umfassende Abdeckung

Nächste Schritte

Wie ist dieser Leitfaden?

getLocaleEmoji