# vue: <Plural>
URL: https://generaltranslation.com/it/docs/vue/reference/components/plural.mdx
---

title: "<Plural>"
description: Renderizza contenuti basati sul conteggio usando le regole plurali dell'impostazione regionale attiva. Riferimento API del componente <Plural>.

---

Il componente `<Plural>` seleziona uno slot denominato in base a un conteggio numerico e alle regole plurali dell&#39;impostazione regionale attiva. Inseriscilo all&#39;interno di [`<T>`](/docs/vue/reference/components/t) quando le relative alternative devono essere tradotte.

## Panoramica [#overview]

Passa il conteggio tramite `n` e definisci slot con nomi statici per le forme necessarie al testo sorgente:

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

Racchiudi un conteggio dinamico in [`<Num>`](/docs/vue/reference/components/num) quando compare nel testo renderizzato di un ramo.

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

* **Override numerici.** Se specificati, `zero` gestisce il valore assoluto `0`; `singular`, poi `one`, gestiscono `1`; `dual`, poi `two`, gestiscono `2`. Questi override vengono applicati prima delle regole dell&#39;impostazione regionale.
* **Selezione basata sull&#39;impostazione regionale.** Altrimenti, `Intl.PluralRules` determina la categoria CLDR dell&#39;impostazione regionale. `singular` e `dual` possono fungere da alias delle categorie `one` e `two` dell&#39;impostazione regionale; quindi `plural` e `other` forniscono fallback generali in quest&#39;ordine.
* **Fallback.** Se nessuna delle forme fornite corrisponde, viene renderizzato lo slot predefinito. Il componente non aggiunge wrapper HTML.
* **Estrazione statica.** All&#39;interno di [`<T>`](/docs/vue/reference/components/t), l&#39;estrattore registra ogni ramo denominato supportato, anche se il rendering a runtime ne seleziona solo uno.

Per un `<Plural>` autonomo, l&#39;impostazione regionale predefinita configurata ignora `locales` espliciti e usa solo quella predefinita. Con un&#39;altra impostazione regionale attiva, un componente autonomo prova, nell&#39;ordine, `locales` espliciti, l&#39;impostazione regionale attiva e quella predefinita.

All&#39;interno di [`<T>`](/docs/vue/reference/components/t), la traduzione avanzata controlla la selezione del plurale. Il contenuto di fallback sorgente usa l&#39;impostazione regionale predefinita; il contenuto tradotto prova l&#39;impostazione regionale attiva e poi quella predefinita. In questo caso, una prop `locales` esplicita viene ignorata.

## Props e slot [#props]

| Nome                       | Descrizione                                              | Tipo         | Facoltativo | Predefinito                                        |
| -------------------------- | -------------------------------------------------------- | ------------ | ----------- | -------------------------------------------------- |
| [`n`](#n)                  | Conteggio usato per selezionare una forma plurale.       | `number`     | No          | —                                                  |
| [`locales`](#locales)      | Locales preferiti per la selezione della forma plurale.  | `string[]`   | Sì          | Ordine di risoluzione delle impostazioni regionali |
| [`default`](#default-slot) | Contenuto renderizzato quando nessuna forma corrisponde. | `VNodeChild` | Sì          | Vuoto                                              |
| [`[form]`](#form-slots)    | Contenuto per una forma plurale supportata.              | `VNodeChild` | Sì          | —                                                  |

### `n`

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

Il valore usato per scegliere una categoria plurale. Visualizza il valore separatamente con [`<Num>`](/docs/vue/reference/components/num); `n` controlla solo la selezione.

### `locales`

**Tipo** `string[]` · **Facoltativo** · **Predefinito** Ordine di risoluzione dell&#39;impostazione regionale

Codici locale BCP 47 preferiti per regole plurali autonome. Hanno priorità solo quando l&#39;impostazione regionale attiva non corrisponde a quella predefinita configurata. All&#39;interno di [`<T>`](/docs/vue/reference/components/t), la prop viene ignorata.

### Slot predefinito

**Tipo** `VNodeChild` · **Facoltativo** · **Predefinito** Vuoto

Contenuto renderizzato quando nessuno degli slot denominati forniti corrisponde alla forma selezionata.

### Slot per le forme

**Tipo** `VNodeChild` · **Facoltativo**

I nomi supportati sono:

* Categorie CLDR: `zero`, `one`, `two`, `few`, `many` e `other`
* Alias generici: `singular`, `dual` e `plural`

Aggiungi solo le categorie necessarie per le `locales` supportate. Poiché gli override numerici vengono applicati per primi, uno slot `one` fornito gestisce qualsiasi valore assoluto pari a `1` e uno slot `two` fornito gestisce qualsiasi valore assoluto pari a `2`, anche quando la categoria CLDR della `impostazione regionale` è diversa. Gli altri valori seguono la categoria della `impostazione regionale` e l&#39;ordine di fallback.

All&#39;interno di [`<T>`](/docs/vue/reference/components/t), gli slot per le forme devono essere incondizionati, avere un nome statico ed essere senza scope. Uno slot con nome ha la precedenza su un attributo primitivo statico con lo stesso nome. Sono supportati anche attributi stringa statici per alternative semplici:

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

## Esempi [#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>Hai <Num :value="count" /> messaggio.</template>
      <template #other>Hai <Num :value="count" /> messaggi.</template>
      <template #default>Nessun messaggio.</template>
    </Plural>
  </T>
</template>
```

Per effettuare una selezione arbitraria in base ai valori, usa [`<Branch>`](/docs/vue/reference/components/branch).