Utility FunctionsLocales

getLocaleEmoji

API-Referenz für die eigenständige Funktion getLocaleEmoji

Übersicht

Die eigenständige Funktion getLocaleEmoji ruft ein Emoji‑Flag oder Symbol für einen Locale-Code ab, ohne eine Instanz der GT-Klasse zu benötigen. Sie gibt je nach Region des Locales passende Flaggen‑Emojis für Länder und Territorien 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 CustomMapping für locale codes und Emoji-Overrides

Rückgabewert

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

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

Beispiele

Einfaches Abrufen von Emojis

import { getLocaleEmoji } from 'generaltranslation';

// Gängige 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 Sprachen
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 von Unicode-Regionalindikator-Symbolen zurück
  • Benutzerdefinierte Emoji‑Zuordnungen haben Vorrang vor der regionsbasierten Auswahl
  • Unterstützt alle ISO‑3166‑1‑Alpha‑2‑Regioncodes für eine umfassende Abdeckung

Nächste Schritte

Wie ist diese Anleitung?