# generaltranslation: General Translation Core SDK: CustomMapping
URL: https://generaltranslation.com/fr/docs/core/types/custom-mapping.mdx
---
title: CustomMapping
description: Définition de type pour les mappages personnalisés de codes de langue et les métadonnées enrichies du paramètre régional
---

## Vue d’ensemble

`CustomMapping` définit des mappages personnalisés de codes de langue et des métadonnées qui étendent ou remplacent les informations standard des paramètres régionaux BCP-47.

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


## Définition de type

### Structure

`CustomMapping` est un record où :

* **Clés** : des codes de langue personnalisés ou des alias (par exemple, `'simplified-chinese'`, `'company-english'`)
* **Valeurs** : soit une simple chaîne, soit un objet `LocaleProperties` partiel

### Types de valeurs

| Type                        | Description                                   | Exemple                                             |
| --------------------------- | --------------------------------------------- | --------------------------------------------------- |
| `string`                    | Nom d’affichage simple                        | `'Simplified Chinese'`                              |
| `Partial<LocaleProperties>` | Métadonnée enrichie du paramètre régional | `{ code: 'zh-CN', name: 'Chinese', emoji: '🇨🇳' }` |

***

## Exemples

### Correspondances simples de chaînes

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

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


### Métadonnée enrichie du paramètre régional

```typescript copy
const enhancedMapping: CustomMapping = {
  'simplified-chinese': {
    code: 'zh-CN',
    name: 'Simplified Chinese',
    nativeName: '简体中文',
    regionName: 'China',
    emoji: '🇨🇳'
  }
};
```

***


## Remarques

* Les mappages personnalisés priment sur la résolution standard des paramètres régionaux BCP-47
* Les valeurs de type chaîne fournissent de simples noms d’affichage
* Les `LocaleProperties` partielles permettent une personnalisation fine des paramètres régionaux
* Les mappages personnalisés sont résolus lors de l’initialisation de l’instance GT

## Types connexes

* [`LocaleProperties`](/docs/core/types/locale-properties) - Structure complète des métadonnées du paramètre régional