# generaltranslation: General Translation Core SDK: DataFormat
URL: https://generaltranslation.com/fr/docs/core/types/data-format.mdx
---
title: DataFormat
description: Énumération des formats de contenu pris en charge pour la traduction
---

## Vue d’ensemble

`DataFormat` spécifie le format du contenu à traduire.

```typescript
type DataFormat = 'JSX' | 'ICU' | 'I18NEXT' | 'STRING';
```


## Définition de type

### Valeurs

| Valeur      | Description                   | Type de contenu           | Cas d’usage                                              |
| ----------- | ----------------------------- | ------------------------- | -------------------------------------------------------- |
| `'JSX'`     | Format de composant JSX/React | `JsxChildren`             | Composants d’interface riches avec éléments et variables |
| `'ICU'`     | Format MessageFormat ICU      | `IcuMessage` (chaîne)     | Mise en forme complexe avec pluriels, dates et nombres   |
| `'I18NEXT'` | Format de message i18next     | `I18nextMessage` (chaîne) | Interpolation simple, projets i18next existants          |
| `'STRING'`  | Format en chaîne simple       | `string`                  | Contenu textuel simple                                   |

### Caractéristiques des formats

| Format      | Variables                | Pluralisation          | Éléments HTML                      | Formatage des dates/nombres |
| ----------- | ------------------------ | ---------------------- | ---------------------------------- | --------------------------- |
| **JSX**     | ✅ Variables enrichies    | ✅ Via des branchements | ✅ Prise en charge complète du HTML | ✅ Via des variables         |
| **ICU**     | ✅ Syntaxe `{variable}`   | ✅ Pluriels intégrés    | ❌ Texte uniquement                 | ✅ Formateurs intégrés       |
| **I18NEXT** | ✅ Syntaxe `{{variable}}` | ✅ Via `count`          | ❌ Texte uniquement                 | ✅ Via des formateurs        |
| **STRING**  | ❌                        | ❌                      | ❌                                  | ❌                           |

***

## Exemples

### Spécification du format

```typescript copy
const icuEntry: TranslateManyEntry = {
  source: 'Hello {name}',
  metadata: { dataFormat: 'ICU' }
};

const plainEntry: TranslateManyEntry = {
  source: 'Hello, world!',
  metadata: { dataFormat: 'STRING' }
};
```

***


## Remarques

* DataFormat détermine la façon dont le contenu est traité par le système de traduction
* La spécification du format dans les métadonnées garantit un traitement adéquat du contenu
* La détection automatique est possible, mais il est recommandé de spécifier explicitement le format

## Types associés

* [`Content`](/docs/core/types/Content) - Union de tous les types de contenu
* [`JsxChildren`](/docs/core/types/jsx-children) - Contenu au format JSX