Descripción general

CustomMapping define asignaciones personalizadas de códigos de configuración regional y metadatos que amplían o sustituyen la información estándar de configuración regional de BCP‑47.

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

Definición de tipos

Estructura

CustomMapping es un registro en el que:

• Claves: Códigos de configuración regional personalizados o alias (p. ej., 'simplified-chinese', 'company-english')
• Valores: Un name de tipo cadena simple o un objeto LocaleProperties parcial

Tipos de valores

Ejemplos

Asignaciones de cadenas simples

const simpleMapping: CustomMapping = {
  'english': 'Inglés',
  'spanish': 'Español',
  'mexican-spanish': 'Español mexicano'
};

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

Metadatos de locale mejorados

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

Notas

• Los mapeos personalizados sustituyen la resolución estándar de locale BCP-47
• Los valores de texto proporcionan nombres de visualización simples
• Las LocaleProperties parciales permiten una personalización detallada del locale
• Los mapeos personalizados se resuelven durante la inicialización de la instancia de GT

Tipos relacionados

• LocaleProperties - Estructura completa de metadatos de locale