Présentation

CustomMapping définit des correspondances personnalisées de codes de locale et des métadonnées qui étendent ou remplacent les informations de locale standard BCP‑47.

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

Définition de type

Structure

CustomMapping est un enregistrement où :

• Keys : codes de locale personnalisés ou alias (par exemple : 'simplified-chinese', 'company-english')
• Values : soit une simple chaîne de caractères (name), soit un objet LocaleProperties partiel

Types de valeurs

Exemples

Mappages simples de chaînes

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

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

Métadonnées de locale enrichies

const enhancedMapping: CustomMapping = {
  'simplified-chinese': {
    code: 'zh-CN',
    name: 'Chinois simplifié',
    nativeName: '简体中文',
    regionName: 'Chine',
    emoji: '🇨🇳'
  }
};

Notes

• Les mappages personnalisés supplantent la résolution standard des locales BCP‑47
• Les valeurs de chaîne fournissent de simples noms d’affichage
• Des LocaleProperties partielles permettent une personnalisation fine des locales
• Les mappages personnalisés sont résolus lors de l’initialisation de l’instance GT

Types associés

• LocaleProperties - Structure complète des métadonnées de locale