Présentation

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

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

Définition de type

Structure

CustomMapping est un enregistrement où :

• Clés : codes de locale personnalisés ou alias (p. ex. 'simplified-chinese', 'company-english')
• Valeurs : soit un simple libellé (chaîne) soit un objet LocaleProperties partiel

Types de valeurs

Exemples

Mappages de chaînes simples

const simpleMapping: CustomMapping = {
  'english': 'Anglais',
  'spanish': 'Espagnol',
  'mexican-spanish': 'Espagnol mexicain'
};

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 remplacent la résolution de locale standard BCP‑47
• Les chaînes de caractères fournissent des noms d’affichage simples
• Des LocaleProperties partielles permettent une personnalisation fine de la locale
• 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