Übersicht

CustomMapping definiert benutzerdefinierte Zuordnungen von locale codes und Metadaten, die die standardmäßigen BCP‑47‑Informationen zu locales erweitern oder überschreiben.

type CustomMapping = Record<string, string | Partial<LocaleProperties>>;

Typdefinition

Struktur

CustomMapping ist ein Record mit:

• Keys: Benutzerdefinierte locale codes oder Aliasse (z. B. ‚simplified-chinese‘, ‚company-english‘)
• Values: Entweder ein einfacher String-Name oder ein partielles LocaleProperties-Objekt

Werttypen

Beispiele

Einfache String-Zuordnungen

const simpleMapping: CustomMapping = {
  'english': 'English',
  'spanish': 'Spanish',
  'mexican-spanish': 'Mexican Spanish'
};

const gt = new GT({
  sourceLocale: 'english',
  targetLocale: 'spanish',
  customMapping: simpleMapping
});

Erweiterte locale-Metadaten

const enhancedMapping: CustomMapping = {
  'simplified-chinese': {
    code: 'zh-CN',
    name: 'Vereinfachtes Chinesisch',
    nativeName: '简体中文',
    regionName: 'China',
    emoji: '🇨🇳'
  }
};

Hinweise

• Benutzerdefinierte Zuordnungen überschreiben die standardmäßige BCP-47-Locale-Auflösung
• String-Values liefern einfache Anzeigenamen
• Partielle LocaleProperties ermöglichen eine detaillierte Locale-Anpassung
• Benutzerdefinierte Zuordnungen werden während der Initialisierung der GT-Instanz aufgelöst

Verwandte Typen

• LocaleProperties - Vollständige Metadatenstruktur für das Locale