# generaltranslation: General Translation Core SDK: formatListToParts
URL: https://generaltranslation.com/fr/docs/core/class/methods/formatting/format-list-to-parts.mdx
---
title: formatListToParts
description: Référence API de la méthode formatListToParts pour formater des listes en éléments tout en préservant les types d’origine
---

## Vue d’ensemble

La méthode `formatListToParts` formate un tableau en segments spécifiques au paramètre régional, en insérant des chaînes de caractères de séparation entre les éléments tout en préservant le type d’origine de chacun.
Contrairement à `formatList`, qui renvoie une chaîne de caractères simple, cette méthode renvoie un `Array<T | string>` — ce qui la rend idéale pour les tableaux hétérogènes contenant des chaînes de caractères, des nombres, des objets ou des éléments JSX.

```typescript
const gt = new GT({ locales: ['en'] });

const parts = gt.formatListToParts(['apple', 42, { type: 'fruit' }]);
// Retourne : ['apple', ', ', 42, ', and ', { type: 'fruit' }]
```


## Référence

### Paramètres

| Nom        | Type                     | Description                               |
| ---------- | ------------------------ | ----------------------------------------- |
| `array`    | `Array<T>`               | Le tableau des éléments à mettre en forme |
| `options?` | `ListFormatPartsOptions` | Options de mise en forme facultatives     |

### ListFormatPartsOptions

Étend `Intl.ListFormatOptions` avec une option supplémentaire de spécification du paramètre régional :

| Name       | Type                                       | Description                                                                                        |
| ---------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| `locales?` | `string \| string[]`                       | Remplace les paramètres régionaux utilisés pour le formatage (par défaut : ceux de l&#39;instance) |
| `type?`    | `'conjunction' \| 'disjunction' \| 'unit'` | Type de formatage de liste (par défaut : `'conjunction'`)                                          |
| `style?`   | `'long' \| 'short' \| 'narrow'`            | Style de formatage de liste (par défaut : `'long'`)                                                |

### Renvoie

`Array<T | string>` - Un tableau contenant les éléments d’origine, entrecoupés de chaînes de séparation spécifiques au paramètre régional.

***

## Exemples

### Mise en forme de liste simple

```typescript copy
import { GT } from 'generaltranslation';

const gt = new GT({ locales: ['en'] });

// Conjonction (par défaut) — liste avec « et »
console.log(gt.formatListToParts(['A', 'B', 'C']));
// Sortie : ['A', ', ', 'B', ', and ', 'C']

// Disjonction — liste avec « ou »
console.log(gt.formatListToParts(['A', 'B', 'C'], { type: 'disjunction' }));
// Sortie : ['A', ', ', 'B', ', or ', 'C']
```


### Tableaux hétérogènes

```typescript copy
// Les nombres et les objets sont préservés
console.log(gt.formatListToParts(['apple', 42, { type: 'fruit' }]));
// Sortie : ['apple', ', ', 42, ', and ', { type: 'fruit' }]
```


### Variantes de style

```typescript copy
// Style courte
console.log(gt.formatListToParts(['first', 'second'], { style: 'short' }));
// Sortie : ['first', ' & ', 'second']

// Style unité
console.log(gt.formatListToParts(['1km', '2mi'], { type: 'unit' }));
// Sortie : ['1km', ', ', '2mi']
```


### Formatage spécifique au paramètre régional

```typescript copy
// Disjonction en espagnol
console.log(gt.formatListToParts(['red', 'green', 'blue'], {
  locales: ['es'],
  type: 'disjunction'
}));
// Résultat : ['red', ', ', 'green', ' o ', 'blue']
```

***


## Remarques

* Les types d’éléments d’origine sont préservés — seuls des séparateurs de chaîne de caractères sont insérés entre les éléments
* C’est ce qui le distingue principalement de `formatList`, qui renvoie une simple chaîne de caractères
* Particulièrement utile pour le rendu de tableaux hétérogènes dans des frameworks d’interface comme React
* La méthode s’appuie en interne sur l’API native du navigateur `Intl.ListFormat`
* `type: 'conjunction'` produit des listes avec « et », `'disjunction'` des listes avec « ou », et `'unit'` des listes au format unité

## Étapes suivantes

* Consultez la documentation de [`Intl.ListFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/ListFormat) pour découvrir d’autres options
* Consultez [`format-num`](/docs/core/class/methods/formatting/format-num) pour le formatage des nombres
* Consultez la version autonome de [`format-list-to-parts`](/docs/core/functions/formatting/format-list-to-parts) pour l’utiliser sans instance GT
* Consultez [`format-message`](/docs/core/class/methods/formatting/format-message) pour le formatage des messages avec interpolation de liste