Panoramica

CustomMapping definisce mappature personalizzate dei codici locale e metadati che estendono o sovrascrivono le informazioni standard dei locale BCP‑47.

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

Definizione del tipo

Struttura

CustomMapping è un record in cui:

• Chiavi: Codici locale personalizzati o alias (ad es. 'simplified-chinese', 'company-english')
• Valori: Un semplice nome come stringa oppure un oggetto LocaleProperties parziale

Tipi di valore

Esempi

Mappature di stringhe semplici

const simpleMapping: CustomMapping = {
  'english': 'Inglese',
  'spanish': 'Spagnolo',
  'mexican-spanish': 'Spagnolo messicano'
};

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

Metadati locali avanzati

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

Note

• Le mappature personalizzate hanno la precedenza sulla risoluzione della locale standard BCP‑47
• I valori stringa forniscono nomi visualizzati semplici
• Le proprietà locali parziali (Partial LocaleProperties) consentono una personalizzazione dettagliata della locale
• Le mappature personalizzate vengono risolte durante l’inizializzazione dell’istanza di GT

Tipi correlati

• LocaleProperties - Struttura completa dei metadati della lingua/locale