# General Translation React SDKs (gt-react, gt-next): Plural
URL: https://generaltranslation.com/it/docs/react/reference/components/plural.mdx
---

title: Plural
description: Esegui il rendering di contenuti basati sul numero usando le regole del plurale dell'impostazione regionale attiva con General Translation gt-react. Riferimento API per Plural.

---

Il componente `<Plural>` coniuga una frase in base a un numero, usando le regole del plurale dell&#39;impostazione regionale attiva. Seleziona la forma corretta per un numero: l&#39;inglese ne richiede due (&quot;one item&quot; / &quot;two items&quot;), mentre altre lingue possono richiederne fino a sei.

*Disponibile in `gt-react`, `gt-next`, `gt-tanstack-start` e `gt-react-native`. Gli esempi importano da `gt-react`; importa invece dal pacchetto del framework che usi.*

## Panoramica [#overview]

Passa il numero come `n` e fornisci una prop `child` per ogni forma plurale.

```tsx
<Plural
  n={count}
  one={<>You have one item.</>}
  other={<>You have some items.</>}
/>
```

*Nota: inserisci `<Plural>` all&#39;interno di un [`<T>`](/docs/react/reference/components/t) per tradurne i casi e racchiudi i valori dinamici al suo interno in un componente variabile come [`<Num>`](/docs/react/reference/components/num).*

## Come funziona [#how-it-works]

* **Selezione basata sull&#39;impostazione regionale.** Il valore di `n` viene associato a una categoria plurale in base alle [regole dei plurali Unicode CLDR](https://cldr.unicode.org/index/cldr-spec/plural-rules) dell&#39;impostazione regionale attiva. Viene quindi mostrato il ramo corrispondente a quella categoria.
* **Fallback.** Se non esiste alcun ramo corrispondente, viene mostrato `children` come fallback.
* **Fallback in assenza di un numero.** Se `n` è assente o non è un numero valido, `<Plural>` mostra `children` come fallback invece di generare un errore.

## Quali forme aggiungere [#forms]

Ti servono solo le forme plurali usate nella tua lingua. Le forme possibili sono `zero`, `one`, `two`, `few`, `many`, `other`, più gli alias `singular`, `dual` e `plural`.

* In `en-US`, usa `one` e `other` (oppure `singular` e `plural`).
* In `zh-CN`, serve solo `other`.

Consulta le [regole CLDR per il plurale](https://cldr.unicode.org/index/cldr-spec/plural-rules) per le forme di ogni lingua.

## Props [#props]

| Prop                    | Descrizione                                                         | Tipo        | Facoltativo | Predefinito                   |
| ----------------------- | ------------------------------------------------------------------- | ----------- | ----------- | ----------------------------- |
| [`n`](#n)               | Il numero che seleziona la forma plurale.                           | `number`    | No          | —                             |
| [`children`](#children) | Contenuto di fallback se nessun ramo corrisponde.                   | `ReactNode` | Sì          | —                             |
| [`locales`](#locales)   | Override dell&#39;impostazione regionale per le regole del plurale. | `string[]`  | Sì          | Impostazione regionale attiva |
| [`[form]`](#form)       | Contenuto per una categoria plurale.                                | `ReactNode` | Sì          | —                             |

### `n` [#n]

**Tipo** `number` · **Obbligatorio**

Il numero utilizzato per determinare la forma plurale. Se manca o non è un numero valido, `<Plural>` renderizza `children` come fallback invece di generare un errore.

### `children` [#children]

**Tipo** `ReactNode` · **Facoltativo**

Contenuto di fallback visualizzato quando nessun ramo plurale corrisponde a `n`.

### `locales` [#locales]

**Tipo** `string[]` · **Facoltativo** · **Predefinito** Impostazione regionale attiva

Impostazioni regionali le cui regole di plurale vengono utilizzate. Se omesse, viene usata l&#39;impostazione regionale attiva.

### `[form]` [#form]

**Tipo** `ReactNode` · **Facoltativo**

Una prop per ciascuna categoria del plurale — `zero`, `one`, `two`, `few`, `many`, `other` (o con gli alias `singular`, `dual` e `plural`). Le categorie disponibili dipendono dall&#39;impostazione regionale.

## Esempi [#examples]

```tsx title="BasicExample.tsx"
import { Plural } from 'gt-react';

export default function ItemCount({ count }) {
  return (
    <Plural
      n={count} // [!code highlight]
      one={<>You have one item.</>}
      other={<>You have some items.</>}
    />
  );
}
```

```tsx title="FallbackExample.tsx"
import { Plural } from 'gt-react';

export default function ItemCount({ count }) {
  return (
    <Plural n={count} one={<>You have one item.</>}>
      You have some items. // [!code highlight]
    </Plural>
  );
}
```

```tsx title="PluralExample.tsx"
import { T, Plural, Num } from 'gt-react';

export default function ItemCount({ count }) {
  return (
    <T>
      <Plural
        n={count}
        one={<>You have <Num>{count}</Num> item.</>} // [!code highlight]
        other={<>You have <Num>{count}</Num> items.</>} // [!code highlight]
      />
    </T>
  );
}
```

## Note [#notes]

* `<Plural>` gestisce la pluralizzazione in base all&#39;impostazione regionale attiva.
* Le diramazioni disponibili dipendono dall&#39;impostazione regionale e seguono le [regole CLDR di Unicode per i plurali](https://cldr.unicode.org/index/cldr-spec/plural-rules).
* Consulta [`<Branch>`](/docs/react/reference/components/branch) per eseguire diramazioni arbitrarie basate sui valori.