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

title: Plural
description: Affiche un contenu basé sur un nombre à l’aide des règles de pluriel du paramètre régional actif avec General Translation gt-react. Référence de l’API pour Plural.

---

Le composant `<Plural>` adapte une phrase en fonction d’un nombre, en utilisant les règles de pluriel du paramètre régional actif. Il sélectionne la forme appropriée pour un nombre — l’anglais en nécessite deux (« one item » / « two items »), tandis que d’autres langues peuvent en nécessiter jusqu’à six.

*Disponible dans `gt-react`, `gt-next`, `gt-tanstack-start` et `gt-react-native`. Les exemples importent depuis `gt-react` ; importez plutôt depuis le package de votre framework.*

## Vue d’ensemble [#overview]

Passez le nombre via `n` et fournissez une prop `child` pour chaque forme du pluriel.

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

*Remarque : placez `<Plural>` à l’intérieur d’un [`<T>`](/docs/react/reference/components/t) pour traduire les différentes branches, et encapsulez les valeurs dynamiques qu’il contient dans un composant variable tel que [`<Num>`](/docs/react/reference/components/num).*

## Fonctionnement [#how-it-works]

* **Sélection selon le paramètre régional.** La valeur de `n` est associée à une catégorie de pluriel selon les [règles de pluriel Unicode CLDR](https://cldr.unicode.org/index/cldr-spec/plural-rules) du paramètre régional actif. La branche correspondante est affichée.
* **Contenu de secours.** Si aucune branche correspondante n’existe, `children` est affiché comme contenu de secours.
* **Contenu de secours en l’absence de nombre.** Si `n` est absent ou n’est pas un nombre valide, `<Plural>` affiche `children` comme contenu de secours au lieu de générer une erreur.

## Quelles formes ajouter [#forms]

Vous n’avez besoin que des formes du pluriel utilisées par votre langue. Les formes possibles sont `zero`, `one`, `two`, `few`, `many`, `other`, ainsi que les alias `singular`, `dual` et `plural`.

* En `en-US`, utilisez `one` et `other` (ou `singular` et `plural`).
* En `zh-CN`, seul `other` est nécessaire.

Consultez les [règles de pluriel du CLDR](https://cldr.unicode.org/index/cldr-spec/plural-rules) pour connaître les formes de chaque langue.

## Props [#props]

| Prop                    | Description                                                 | Type        | Facultatif | Par défaut               |
| ----------------------- | ----------------------------------------------------------- | ----------- | ---------- | ------------------------ |
| [`n`](#n)               | Le nombre qui détermine la forme du pluriel.                | `number`    | Non        | —                        |
| [`children`](#children) | Contenu de secours lorsqu’aucune branche ne correspond.     | `ReactNode` | Oui        | —                        |
| [`locales`](#locales)   | Surcharge du paramètre régional pour les règles du pluriel. | `string[]`  | Oui        | Paramètre régional actif |
| [`[form]`](#form)       | Contenu d’une catégorie de pluriel.                         | `ReactNode` | Oui        | —                        |

### `n` [#n]

**Type** `number` · **Requis**

Le nombre utilisé pour déterminer la forme du pluriel. S’il est absent ou n’est pas un nombre valide, `<Plural>` affiche `children` comme contenu de secours au lieu de provoquer une erreur.

### `children` [#children]

**Type** `ReactNode` · **Facultatif**

Contenu de secours affiché lorsqu’aucune branche de pluriel ne correspond à `n`.

### `locales` [#locales]

**Type** `string[]` · **Facultatif** · **Par défaut** paramètre régional actif

Paramètres régionaux dont les règles de pluriel s’appliquent. Si cette valeur est omise, le paramètre régional actif est utilisé.

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

**Type** `ReactNode` · **Facultatif**

Une prop pour chaque catégorie de pluriel — `zero`, `one`, `two`, `few`, `many`, `other` (ou les alias `singular`, `dual` et `plural`). Les catégories disponibles dépendent du paramètre régional.

## Exemples [#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>
  );
}
```

## Remarques [#notes]

* `<Plural>` gère la pluralisation en fonction du paramètre régional actif.
* Les branches disponibles dépendent du paramètre régional et suivent les [règles de pluriel Unicode CLDR](https://cldr.unicode.org/index/cldr-spec/plural-rules).
* Voir [`<Branch>`](/docs/react/reference/components/branch) pour un branchement arbitraire en fonction de valeurs.