# vue: <Plural>
URL: https://generaltranslation.com/fr/docs/vue/reference/components/plural.mdx
---
title: "<Plural>"
description: Affiche du contenu en fonction d'un nombre selon les règles de pluriel du paramètre régional actif. Référence de l'API du composant <Plural>.

---

Le composant `<Plural>` sélectionne un slot nommé en fonction d&#39;un nombre et des règles de pluriel du paramètre régional actif. Placez-le dans [`<T>`](/docs/vue/reference/components/t) lorsque ses variantes doivent être traduites.

## Vue d’ensemble [#overview]

Transmettez le nombre via `n` et définissez des slots nommés statiquement pour les formes requises par votre texte source :

```vue
<Plural :n="count">
  <template #one>One item</template>
  <template #other>Several items</template>
  <template #default>No matching form</template>
</Plural>
```

Encapsulez un nombre dynamique dans [`<Num>`](/docs/vue/reference/components/num) lorsqu’il apparaît dans le texte affiché d’une branche.

## Fonctionnement [#how-it-works]

* **Priorités numériques.** Lorsqu&#39;ils sont fournis, `zero` gère la valeur absolue `0` ; `singular`, puis `one`, gèrent `1` ; et `dual`, puis `two`, gèrent `2`. Ces priorités s&#39;appliquent avant les règles du paramètre régional.
* **Sélection selon le paramètre régional.** Sinon, `Intl.PluralRules` détermine la catégorie CLDR du paramètre régional. `singular` et `dual` peuvent servir d&#39;alias pour les catégories `one` et `two` du paramètre régional ; `plural`, puis `other`, fournissent ensuite des contenus de secours généraux, dans cet ordre.
* **Contenu de secours.** Si aucune des formes fournies ne correspond, le slot par défaut s&#39;affiche. Le composant n&#39;ajoute aucun conteneur HTML.
* **Extraction statique.** À l&#39;intérieur de [`<T>`](/docs/vue/reference/components/t), l&#39;extracteur enregistre chaque branche nommée prise en charge, même si l&#39;affichage à l&#39;exécution n&#39;en sélectionne qu&#39;une.

Pour un `<Plural>` autonome, le paramètre régional par défaut configuré ignore les `locales` explicites et utilise uniquement ce paramètre régional. Pour tout autre paramètre régional actif, un composant autonome essaie les `locales` explicites, le paramètre régional actif, puis le paramètre régional par défaut, dans cet ordre.

À l&#39;intérieur de [`<T>`](/docs/vue/reference/components/t), la traduction enrichie contrôle la sélection du pluriel. Le contenu de secours de la source utilise le paramètre régional par défaut ; le contenu traduit essaie le paramètre régional actif, puis le paramètre régional par défaut. Une prop `locales` explicite est ignorée dans ce cas.

## Props et slots [#props]

| Nom                        | Description                                                             | Type         | Facultatif | Par défaut                                   |
| -------------------------- | ----------------------------------------------------------------------- | ------------ | ---------- | -------------------------------------------- |
| [`n`](#n)                  | Nombre utilisé pour sélectionner une forme du pluriel.                  | `number`     | Non        | —                                            |
| [`locales`](#locales)      | Paramètres régionaux préférés pour la sélection de la forme du pluriel. | `string[]`   | Oui        | Ordre de résolution des paramètres régionaux |
| [`default`](#default-slot) | Contenu affiché lorsqu’aucune forme ne correspond.                      | `VNodeChild` | Oui        | Vide                                         |
| [`[form]`](#form-slots)    | Contenu associé à une forme du pluriel prise en charge.                 | `VNodeChild` | Oui        | —                                            |

### `n`

**Type** `number` · **Obligatoire**

Le nombre utilisé pour choisir une catégorie plurielle. Affichez-le séparément avec [`<Num>`](/docs/vue/reference/components/num) ; `n` contrôle uniquement la sélection.

### `locales`

**Type** `string[]` · **Facultatif** · **Par défaut** Ordre de résolution des paramètres régionaux

Codes de langue BCP 47 privilégiés pour les règles de pluriel autonomes. Ils ne sont prioritaires que lorsque le paramètre régional actif n’est pas celui configuré par défaut. Dans [`<T>`](/docs/vue/reference/components/t), cette prop est ignorée.

### Slot par défaut

**Type** `VNodeChild` · **Facultatif** · **Par défaut** Vide

Contenu affiché lorsqu’aucun slot nommé fourni ne correspond à la forme sélectionnée.

### Slots de forme

**Type** `VNodeChild` · **Facultatif**

Les noms pris en charge sont :

* Catégories CLDR : `zero`, `one`, `two`, `few`, `many` et `other`
* Alias généraux : `singular`, `dual` et `plural`

Ajoutez uniquement les catégories nécessaires pour les paramètres régionaux pris en charge. Comme les substitutions numériques sont appliquées en premier, un slot `one` fourni gère toute valeur absolue égale à `1`, et un slot `two` toute valeur absolue égale à `2`, même si la catégorie CLDR du paramètre régional diffère. Les autres valeurs suivent la catégorie du paramètre régional et l&#39;ordre de secours.

Dans [`<T>`](/docs/vue/reference/components/t), les slots de forme doivent être inconditionnels, avoir un nom statique et ne pas être scopés. Un slot nommé prévaut sur un attribut primitif statique du même nom. Les attributs de chaîne statiques sont également pris en charge pour les alternatives simples :

```vue
<Plural :n="count" one="One item" other="Several items" />
```

## Exemples [#examples]

```vue title="InboxCount.vue"
<script setup lang="ts">
import { Num, Plural, T } from 'gt-vue';

defineProps<{ count: number }>();
</script>

<template>
  <T>
    <Plural :n="count">
      <template #one>You have <Num :value="count" /> message.</template>
      <template #other>You have <Num :value="count" /> messages.</template>
      <template #default>No messages.</template>
    </Plural>
  </T>
</template>
```

Pour une sélection selon une valeur arbitraire, utilisez [`<Branch>`](/docs/vue/reference/components/branch).