[#362] Création d'un composant de type Montant (#4)

| Numéro du ticket | Titre du ticket |
|------------------|-----------------|
|          #362        |       Création d'un composant de type Montant          |

## Description de la PR

## Modification du .env

## Check list

- [x] Pas de régression
- [x] TU/TI/TF rédigée
- [x] TU/TI/TF OK
- [x] CHANGELOG modifié

Reviewed-on: #4
Reviewed-by: Autin <tristan@yuno.malio.fr>
Co-authored-by: kevin <kevin@yuno.malio.fr>
Co-committed-by: kevin <kevin@yuno.malio.fr>
This commit was merged in pull request #4.
This commit is contained in:
2026-03-03 10:42:39 +00:00
committed by Autin
parent 1ab7b2427a
commit 77364daa67
4 changed files with 678 additions and 0 deletions

View File

@@ -0,0 +1,200 @@
<template>
<Story
title="Input/Amount"
>
<MalioInputAmount/>
</Story>
</template>
<docs lang="md">
# MalioInputAmount
Composant input dédié à la saisie dun montant décimal avec label flottant,
états visuels (erreur / succès) et icône configurable.
------------------------------------------------------------------------
## Props détaillées
### id
- Type: string
- Description: Identifiant HTML de linput.
- Comportement: Si non fourni, un id unique est généré automatiquement.
### label
- Type: string
- Description: Texte affiché comme label flottant.
- Comportement: Si absent, aucun label nest rendu.
### name
- Type: string
- Description: Attribut `name` de linput, utile dans les formulaires.
### autocomplete
- Type: string
- Description: Valeur de lattribut `autocomplete`.
- Défaut: `off`
### modelValue
- Type: string | null | undefined
- Description: Valeur contrôlée du composant.
- Comportement:
- Si défini, le composant fonctionne via `v-model`.
- Sinon, il conserve une valeur locale interne.
------------------------------------------------------------------------
## Apparence & Style
### inputClass
- Type: string
- Description: Classes CSS additionnelles appliquées à linput.
### labelClass
- Type: string
- Description: Classes CSS additionnelles appliquées au label.
### groupClass
- Type: string
- Description: Classes CSS additionnelles appliquées au conteneur.
------------------------------------------------------------------------
## Validation & Contraintes
### required
- Type: boolean
- Description: Ajoute lattribut HTML `required`.
### maxLength
- Type: number | string
- Description: Longueur maximale autorisée.
### minLength
- Type: number | string
- Description: Longueur minimale autorisée.
### disabled
- Type: boolean
- Description: Désactive complètement le champ.
### readonly
- Type: boolean
- Description: Rend le champ non modifiable mais focusable.
------------------------------------------------------------------------
## États & Messages
### hint
- Type: string
- Description: Message daide affiché sous le champ.
### error
- Type: string
- Description: Message derreur.
- Effet:
- Active létat visuel erreur.
- Positionne `aria-invalid="true"`.
- Est prioritaire sur `success` et `hint`.
### success
- Type: string
- Description: Message de succès.
- Effet:
- Actif uniquement si `error` est absent.
------------------------------------------------------------------------
## Icône
### iconName
- Type: string
- Description: Nom de licône affichée dans le champ.
- Défaut: `mdi:currency-eur`
### iconPosition
- Type: `'left' | 'right'`
- Description: Position de licône dans le champ.
- Défaut: `right`
### iconSize
- Type: string | number
- Description: Taille de licône.
### iconColor
- Type: string
- Description: Classe de couleur de licône en état neutre.
------------------------------------------------------------------------
## Comportement montant
- Le champ est rendu en `type="text"` avec `inputmode="decimal"`.
- Le séparateur décimal affiché par défaut est `.`.
- Les virgules saisies par lutilisateur sont converties en points.
- Tous les caractères non numériques, sauf le séparateur décimal, sont supprimés.
- La partie décimale est limitée à 2 chiffres.
### Exemples de normalisation
- `12,5` devient `12.5`
- `0012,345abc` devient `12.34`
- `,5` devient `0.5`
### Formatage au blur
- `12` devient `12.00`
- `12.5` devient `12.50`
------------------------------------------------------------------------
## Priorité visuelle
1. `error`
2. `success`
3. état neutre
------------------------------------------------------------------------
## Accessibilité
- `aria-invalid` est activé si `error` existe.
- `aria-describedby` référence le message affiché sous le champ.
- Le composant fonctionne avec ou sans `v-model`.
------------------------------------------------------------------------
## Events
### update:modelValue
- Émis à chaque modification de linput.
- Émis aussi au `blur` si la valeur est reformatée.
- Permet lutilisation avec `v-model`.
</docs>
<script setup lang="ts">
import MalioInputAmount from '../components/malio/InputAmount.vue'
</script>