# vue: URL: https://generaltranslation.com/fr/docs/vue/reference/components/currency.mdx --- title: "" description: Met en forme un montant dans la devise du paramètre régional actif. Référence de l’API du composant . --- Le composant `` met en forme une `value` numérique obligatoire selon le style de devise d’`Intl.NumberFormat`. Il modifie le format d’affichage, mais ne convertit pas un montant d’une devise à une autre. ## Vue d’ensemble [#overview] Associez le montant à `value` et sélectionnez éventuellement un code de devise ISO 4217 : ```vue ``` Utilisez-le seul ou comme variable d’exécution dans [``](/docs/vue/reference/components/t). ## Fonctionnement [#how-it-works] * Un nombre est formaté localement selon le style de devise. Le montant n’est ni traduit ni envoyé pour conversion. * Une chaîne doit représenter un nombre complet. Les chaînes composées uniquement d’espaces et `null` s’affichent comme vides ; une chaîne numérique non valide s’affiche telle quelle. * `currency` vaut `USD` par défaut. Après avoir fusionné `options`, le composant applique toujours sa prop `currency` de niveau supérieur et le style de devise ; `options.currency` et `options.style` ne peuvent donc pas les remplacer. * Les éléments enfants du slot de formateur sont ignorés. Fournissez toujours `value` et utilisez une balise autofermante. * Le composant n’ajoute aucun conteneur HTML. ### Résolution de paramètre régional Lorsque le paramètre régional actif correspond au paramètre régional par défaut configuré, le formatage utilise uniquement ce dernier et ignore `locales`. Pour tout autre paramètre régional actif, un formateur autonome essaie d’abord les `locales` explicites, puis le paramètre régional actif et enfin le paramètre régional par défaut. Dans [``](/docs/vue/reference/components/t), le contenu de secours source utilise le paramètre régional par défaut. Le contenu traduit essaie d’abord le paramètre régional actif, puis le paramètre régional par défaut, et une prop `locales` explicite est ignorée. ## Props [#props] | Prop | Description | Type | Facultatif | Par défaut | | ----------------------- | ------------------------------------------------- | -------------------------- | ---------- | -------------------------------------------- | | [`value`](#value) | Montant à formater. | `number \| string \| null` | Non | — | | [`currency`](#currency) | Code de devise ISO 4217. | `string` | Oui | `USD` | | [`options`](#options) | Options supplémentaires pour `Intl.NumberFormat`. | `Intl.NumberFormatOptions` | Oui | `{}` | | [`locales`](#locales) | Paramètres régionaux de formatage préférés. | `string[]` | Oui | Ordre de résolution des paramètres régionaux | ### `value` **Type** `number | string | null` · **Obligatoire** Le montant total à formater. Les chaînes numériques sont converties avec `Number()` avant le formatage. La valeur reste dans la devise sélectionnée ; aucun taux de change n’est appliqué. ### `currency` **Type** `string` · **facultatif** · **Par défaut** `USD` Un code ISO 4217 tel que `USD`, `EUR` ou `JPY`. Cette prop détermine la devise, même lorsque `options` contient un champ `currency` différent. ### `options` **Type** `Intl.NumberFormatOptions` · **facultatif** · **Par défaut** `{}` Options supplémentaires transmises à `Intl.NumberFormat`. Les options courantes de formatage des devises incluent : | Option | Description | Type | facultatif | Par défaut | | -------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------- | ---------- | --------------------------------------------- | | `localeMatcher` | Algorithme de correspondance des paramètres régionaux. | `'lookup' \| 'best fit'` | Oui | `'best fit'` | | `numberingSystem` | Système de numérotation, tel que `latn` ou `arab`. | `string` | Oui | Dépend du paramètre régional | | `currencyDisplay` | Mode d'affichage de la devise. | `'code' \| 'symbol' \| 'narrowSymbol' \| 'name'` | Oui | `'symbol'` | | `currencySign` | Notation standard ou comptable pour les valeurs négatives. | `'standard' \| 'accounting'` | Oui | `'standard'` | | `minimumIntegerDigits` | Nombre minimal de chiffres entiers. | `number` | Oui | `1` | | `minimumFractionDigits` | Nombre minimal de chiffres fractionnaires. | `number` | Oui | Dépend de la devise | | `maximumFractionDigits` | Nombre maximal de chiffres fractionnaires. | `number` | Oui | Dépend de la devise | | `minimumSignificantDigits` | Nombre minimal de chiffres significatifs. | `number` | Oui | `1` | | `maximumSignificantDigits` | Nombre maximal de chiffres significatifs. | `number` | Oui | `21` | | `useGrouping` | Quand afficher les séparateurs de groupement. | `boolean \| string` | Oui | Dépend de la notation | | `notation` | Notation des nombres. | `'standard' \| 'scientific' \| 'engineering' \| 'compact'` | Oui | `'standard'` | | `compactDisplay` | Longueur du libellé de notation compacte. | `'short' \| 'long'` | Oui | `'short'` | | `signDisplay` | Quand afficher un signe. | `'auto' \| 'always' \| 'exceptZero' \| 'negative' \| 'never'` | Oui | `'auto'` | | `roundingMode` | Sens utilisé pour l'arrondi. | `string` | Oui | Dépend de l'environnement d'exécution | Le composant impose `style: 'currency'` ainsi que la valeur `currency` de niveau supérieur. Les valeurs par défaut du nombre de chiffres fractionnaires suivent les unités mineures standard de la devise concernée. Consultez les [options de `Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#options) pour connaître l'ensemble complet des options définies par l'environnement d'exécution. ### `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 le formatage autonome. Ils sont utilisés avant les paramètres régionaux actif et par défaut, uniquement lorsque le paramètre régional actif n'est pas celui configuré par défaut. ## Exemples [#examples] ```vue title="OrderTotal.vue" ```