# General Translation React SDKs (gt-react, gt-next, gt-react-native): `<Plural>`
URL: https://generaltranslation.com/it/docs/react/reference/components/plural.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Esegui il rendering di contenuti basati sul numero usando le regole del plurale dell'impostazione regionale attiva. Riferimento API per il componente `<Plural>`.

Il componente `<Plural>` adatta la formulazione in base a un numero, in modo che la frase concordi con il numero in ciascuna lingua. 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`.*

## 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 del plurale Unicode CLDR](https://cldr.unicode.org/index/cldr-spec/plural-rules) dell&#39;impostazione regionale attiva. Viene quindi renderizzato il ramo corrispondente a quella categoria.
* **Fallback del ramo.** Se la categoria selezionata non è disponibile, `<Plural>` usa `plural`, poi `other`. Renderizza `children` solo quando nessuno dei due rami generici esiste.
* **Fallback in assenza di un numero.** Se `n` è assente o non è un numero valido, `<Plural>` renderizza `children` come fallback invece di generare un errore.

<Callout type="info">
  **Modificato nella v11.1.8:** Le categorie `zero` e `one` mancanti ora usano come fallback
  `plural` o `other` prima di `children`, in linea con il comportamento esistente per
  `two`, `few` e `many`.
</Callout>

## 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) | Fallback finale se nessuna categoria o ramo generico 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 nessuna categoria esatta né alcun ramo `plural` o `other` 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]

*Gli esempi importano da `gt-react`; importa invece dal package del tuo framework.*

```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.
* I rami disponibili dipendono dall&#39;impostazione regionale e seguono le [regole del plurale di Unicode CLDR](https://cldr.unicode.org/index/cldr-spec/plural-rules).
* **Componente correlato:** [`<Branch>`](/docs/react/reference/components/branch) gestisce i rami arbitrari basati sui valori.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.