Обзор

CustomMapping задает пользовательские соответствия кодов локали и метаданные, которые дополняют или переопределяют стандартные сведения о локалях по BCP‑47.

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

Определение типов

Структура

CustomMapping — это запись, в которой:

• Ключи: пользовательские коды локалей или псевдонимы (например, 'simplified-chinese', 'company-english')
• Значения: либо простая строка с названием, либо частичный объект LocaleProperties

Типы значений

Примеры

Простые отображения строк

const simpleMapping: CustomMapping = {
  'english': 'Английский',
  'spanish': 'Испанский',
  'mexican-spanish': 'Мексиканский испанский'
};

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

Расширенные метаданные локалей

const enhancedMapping: CustomMapping = {
  'simplified-chinese': {
    code: 'zh-CN',
    name: 'Упрощённый китайский',
    nativeName: '简体中文',
    regionName: 'Китай',
    emoji: '🇨🇳'
  }
};

Примечания

• Пользовательские соответствия переопределяют стандартное разрешение локалей по BCP‑47
• Строковые значения задают простые отображаемые имена
• Частичные LocaleProperties позволяют тонко настраивать локаль
• Пользовательские соответствия обрабатываются при инициализации экземпляра GT

Смежные типы

• LocaleProperties — Полная структура метаданных локали