# generaltranslation: General Translation Core SDK: formatListToParts
URL: https://generaltranslation.com/fr/docs/core/functions/formatting/format-list-to-parts.mdx
---
title: formatListToParts
description: Fonction autonome permettant de formater des listes en éléments tout en préservant les types d’origine
---

## Vue d’ensemble

La fonction autonome `formatListToParts` formate un tableau en éléments spécifiques au paramètre régional sans nécessiter d’instance GT.
Elle insère des chaînes de séparation entre les éléments tout en préservant le type d’origine de chacun, et renvoie un `Array<T | string>`.

```typescript
import { formatListToParts } from 'generaltranslation';

const parts = formatListToParts(['red', 'green', 'blue'], {
  locales: ['es'],
  type: 'disjunction'
});
// Retourne : ['red', ', ', 'green', ' o ', 'blue']
```

## Référence

### Paramètres

| Nom       | Type                                                       | Description                                               |
| --------- | ---------------------------------------------------------- | --------------------------------------------------------- |
| `array`   | `Array<T>`                                                 | Le tableau d’éléments à mettre en forme                   |
| `options` | `ListFormatPartsOptions & { locales: string \| string[] }` | Configuration de mise en forme avec `locales` obligatoire |

### ListFormatPartsOptions

| Nom       | Type                                       | Description                                                       |
| --------- | ------------------------------------------ | ----------------------------------------------------------------- |
| `locales` | `string \| string[]`                       | **Obligatoire** - Paramètres régionaux utilisés pour le formatage |
| `type?`   | `'conjunction' \| 'disjunction' \| 'unit'` | Type de formatage de la liste (par défaut : `'conjunction'`)      |
| `style?`  | `'long' \| 'short' \| 'narrow'`            | Style de formatage de la liste (par défaut : `'long'`)            |

### Renvoie

`Array<T | string>` - Un tableau contenant les éléments d’origine, entrelacés avec des séparateurs de chaîne de caractères propres au paramètre régional.

***

## Exemple

### Utilisation de base

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

// Liste conjonctive
console.log(formatListToParts(['A', 'B', 'C'], { locales: 'en' }));
// Résultat : ['A', ', ', 'B', ', and ', 'C']

// Liste disjonctive
console.log(formatListToParts(['A', 'B', 'C'], { locales: 'en', type: 'disjunction' }));
// Résultat : ['A', ', ', 'B', ', or ', 'C']
```


### Tableaux hétérogènes

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


### Formatage propre au paramètre régional

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

// Style court
console.log(formatListToParts(['first', 'second'], {
  locales: 'en',
  style: 'short'
}));
// Résultat : ['first', ' & ', 'second']
```

***


## Remarques

* Contrairement à la méthode de classe GT, le paramètre `locales` est obligatoire
* 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 la principale différence avec `formatList`, qui renvoie une `chaîne de caractères`
* Particulièrement utile pour le rendu de tableaux de types mixtes dans des frameworks d’interface utilisateur comme React
* Utilise le même `Intl.ListFormat` sous-jacent que la méthode de classe GT

## É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&#39;autres options
* Consultez [`formatNum`](/docs/core/functions/formatting/format-num) pour le formatage autonome des nombres
* Consultez [`formatDateTime`](/docs/core/functions/formatting/format-date-time) pour le formatage autonome des dates et heures
* Consultez la méthode [`formatListToParts`](/docs/core/class/methods/formatting/format-list-to-parts) de la classe GT pour une utilisation via une instance