GT ClassMethodsLocales

getRegionProperties

API Reference für die GT-Methode getRegionProperties

Übersicht

Die Methode getRegionProperties ruft detaillierte Informationen zu einem Regionscode ab, darunter den lokalisierten Namen und die zugehörige Emoji‑Flagge. Sie bietet eine einfache Möglichkeit, regionsspezifische Anzeigeinformationen für den Aufbau internationalisierter Benutzeroberflächen zu beziehen.

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

// Regionseigenschaften abrufen
const usProps = gt.getRegionProperties('US');
console.log(usProps);
// { code: 'US', name: 'Vereinigte Staaten', emoji: '🇺🇸' }

const frProps = gt.getRegionProperties('FR');
console.log(frProps);
// { code: 'FR', name: 'Frankreich', emoji: '🇫🇷' }

// Automatische Erkennung aus dem aktuellen Gebietsschema
const currentRegion = gt.getRegionProperties(); // Verwendet die Region von targetLocale
console.log(currentRegion);
// { code: 'FR', name: 'Frankreich', emoji: '🇫🇷' }

Referenzen

Parameter

Prop

Type

Parameterbeschreibung

ParameterBeschreibung
regionISO-3166-1-Alpha-2- oder UN-M.49-Regionscode. Wenn nicht angegeben, wird die Region aus der Ziel-locale der Instanz verwendet
customMappingOptionale benutzerdefinierte Regionszuordnung zum Überschreiben der Standard-Regionsnamen und emojis

Rückgabewert

{ code: string; name: string; emoji: string } - Objekt mit:

  • code: Der übergebene Regionscode
  • name: Lokalisierter Regionsname in der Zielsprache der Ziel-locale
  • emoji: Zugeordnete Emoji-Flagge oder -Symbol

Beispiele

Basisinformationen zur Region

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

// Häufige Regionscodes
console.log(gt.getRegionProperties('US')); // { code: 'US', name: 'Vereinigte Staaten', emoji: '🇺🇸' }
console.log(gt.getRegionProperties('GB')); // { code: 'GB', name: 'Vereinigtes Königreich', emoji: '🇬🇧' }
console.log(gt.getRegionProperties('DE')); // { code: 'DE', name: 'Deutschland', emoji: '🇩🇪' }
console.log(gt.getRegionProperties('JP')); // { code: 'JP', name: 'Japan', emoji: '🇯🇵' }

Hinweise

  • Verwendet die Intl.DisplayNames‑API für lokalisierte Regionsnamen
  • Unterstützt sowohl ISO 3166-1 Alpha-2 als auch UN M.49-Regioncodes
  • Benutzerdefinierte Zuordnungen überschreiben Standardnamen und Emojis
  • Erkennt die Region automatisch anhand des Ziel-locale, wenn kein Parameter angegeben ist
  • Fällt auf den Regioncode als Namen zurück, wenn die Auflösung des Anzeigenamens fehlschlägt

Nächste Schritte

Wie ist diese Anleitung?