Übersicht

Die Methode getLocaleProperties ruft umfassende Eigenschaften für einen locale code ab und liefert detaillierte Informationen, darunter Anzeigenamen, Regionscodes, Skriptangaben und Flaggen-Emojis. Sie gibt ein vollständiges LocaleProperties-Objekt mit allen erforderlichen Daten für den Aufbau umfassender, internationalisierter Benutzeroberflächen zurück.

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

const props = gt.getLocaleProperties('fr-CA');
console.log(props.name); // "Französisch (Kanada)"
console.log(props.nativeName); // "français (Canada)"
console.log(props.emoji); // "🇨🇦"

Referenz

Parameter

Parameterbeschreibung

Rückgabe

LocaleProperties - Ein umfassendes Objekt mit allen Locale-Informationen:

• code: Standardisierter Locale-Code
• name: Anzeigename in der Quell-Locale
• nativeName: Anzeigename in der jeweiligen Locale
• languageCode, languageName, nativeLanguageName: Sprachinformationen
• regionCode, regionName, nativeRegionName: Regioneninformationen
• scriptCode, scriptName, nativeScriptName: Schriftinformationen
• maximizedCode, minimizedCode: Kanonische Formen
• nameWithRegionCode, nativeNameWithRegionCode: Kombinierte Anzeigeformate
• emoji: Flagge oder repräsentatives Emoji

Wirft

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

Beispiele

Grundlegende Verwendung

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

// Eigenschaften für das Ziel-Locale abrufen
const props = gt.getLocaleProperties();
console.log(props.name); // "Französisch (Frankreich)"
console.log(props.nativeName); // "français (France)"
console.log(props.languageCode); // "fr"
console.log(props.regionCode); // "FR"
console.log(props.emoji); // "🇫🇷"

// Eigenschaften für andere Locales abrufen
const germanProps = gt.getLocaleProperties('de-AT');
console.log(germanProps.name); // "Österreichisches Deutsch"
console.log(germanProps.nativeName); // "Österreichisches Deutsch"
console.log(germanProps.regionName); // "Österreich"
console.log(germanProps.nativeRegionName); // "Österreich"

Hinweise

• Alle Anzeigenamen richten sich nach der sourceLocale-Einstellung der Instanz
• Benutzerdefinierte Mapping-Eigenschaften haben Vorrang vor den Standard‑Intl APIs

Nächste Schritte

• Erkunde die LocaleProperties-Schnittstelle
• Hole einfache Locale-Namen mit getLocaleName
• Hole das Locale-Emoji mit getLocaleEmoji
• Erfahre mehr über den Typ CustomMapping