# generaltranslation: General Translation Core SDK: formatListToParts
URL: https://generaltranslation.com/it/docs/core/functions/formatting/format-list-to-parts.mdx
---
title: formatListToParts
description: Funzione autonoma per suddividere le liste in parti preservando i tipi originali
---

## Panoramica

La funzione autonoma `formatListToParts` suddivide un array in parti specifiche dell'impostazione regionale senza richiedere un'istanza di GT.
Inserisce stringhe separatrici tra gli elementi mantenendo i tipi originali di ciascun elemento e restituisce un `Array<T | string>`.

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

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


## Riferimento

### Parametri

| Name      | Type                                                       | Description                                                          |
| --------- | ---------------------------------------------------------- | -------------------------------------------------------------------- |
| `array`   | `Array<T>`                                                 | L&#39;array di elementi da formattare                                |
| `options` | `ListFormatPartsOptions & { locales: string \| string[] }` | Configurazione di formattazione con impostazioni regionali richieste |

### ListFormatPartsOptions

| Nome      | Tipo                                       | Descrizione                                                             |
| --------- | ------------------------------------------ | ----------------------------------------------------------------------- |
| `locales` | `string \| string[]`                       | **Obbligatorio** - Impostazioni regionali da usare per la formattazione |
| `type?`   | `'conjunction' \| 'disjunction' \| 'unit'` | Tipo di formattazione dell&#39;elenco (predefinito: `'conjunction'`)    |
| `style?`  | `'long' \| 'short' \| 'narrow'`            | Stile di formattazione dell&#39;elenco (predefinito: `'long'`)          |

### Restituisce

`Array<T | string>` - Un array degli elementi originali, intervallati da separatori di stringa specifici dell&#39;impostazione regionale.

***

## Esempio

### Uso di base

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

// Lista congiuntiva
console.log(formatListToParts(['A', 'B', 'C'], { locales: 'en' }));
// Output: ['A', ', ', 'B', ', and ', 'C']

// Lista disgiuntiva
console.log(formatListToParts(['A', 'B', 'C'], { locales: 'en', type: 'disjunction' }));
// Output: ['A', ', ', 'B', ', or ', 'C']
```


### Array con tipi misti

```typescript copy
// Numeri e oggetti vengono preservati
console.log(formatListToParts(['apple', 42, { type: 'fruit' }], { locales: 'en' }));
// Output: ['apple', ', ', 42, ', e ', { type: 'fruit' }]
```


### Formattazione specifica dell’impostazione regionale

```typescript copy
// Disgiunzione spagnola
console.log(formatListToParts(['red', 'green', 'blue'], {
  locales: 'es',
  type: 'disjunction'
}));
// Output: ['red', ', ', 'green', ' o ', 'blue']

// Stile breve
console.log(formatListToParts(['first', 'second'], {
  locales: 'en',
  style: 'short'
}));
// Output: ['first', ' & ', 'second']
```

***


## Note

* A differenza del metodo della classe GT, il parametro `locales` è obbligatorio
* I tipi originali degli elementi vengono preservati: tra gli elementi vengono inseriti solo separatori di stringa
* Questa è la principale differenza rispetto a `formatList`, che restituisce una `string` semplice
* Particolarmente utile per il rendering di array con tipi misti in framework UI come React
* Usa lo stesso `Intl.ListFormat` sottostante del metodo della classe GT

## Passaggi successivi

* Consulta la documentazione di [`Intl.ListFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/ListFormat) per altre opzioni
* Vedi [`formatNum`](/docs/core/functions/formatting/format-num) per la formattazione autonoma dei numeri
* Vedi [`formatDateTime`](/docs/core/functions/formatting/format-date-time) per la formattazione autonoma della data
* Vedi il metodo [`formatListToParts`](/docs/core/class/methods/formatting/format-list-to-parts) della classe GT per l&#39;utilizzo basato su istanza