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
| Parameter | Beschreibung |
|---|---|
region | ISO-3166-1-Alpha-2- oder UN-M.49-Regionscode. Wenn nicht angegeben, wird die Region aus der Ziel-locale der Instanz verwendet |
customMapping | Optionale benutzerdefinierte Regionszuordnung zum Überschreiben der Standard-Regionsnamen und emojis |
Rückgabewert
{ code: string; name: string; emoji: string } - Objekt mit:
code: Der übergebene Regionscodename: Lokalisierter Regionsname in der Zielsprache der Ziel-localeemoji: 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
- Vollständige locale-Eigenschaften mit
getLocalePropertiesabrufen - Locale-emoji mit
getLocaleEmojiabrufen
Wie ist diese Anleitung?