887ebdebd7
## Résumé (MUI-41) Harmonise l'état « obligatoire » des composants de formulaire et normalise le champ email. ### `required` + astérisque - Nouveau composant partagé `MalioRequiredMark` : astérisque rouge (`text-m-danger`, **16px**), `aria-hidden`. - Prop `required` désormais cohérente sur toute la famille formulaire ; quand vraie, l'astérisque s'affiche **dans le label**. - Prop ajoutée à `Select`, `SelectCheckbox`, `InputUpload`, `InputRichText` (les autres l'avaient déjà). - Accessibilité : `required` natif là où l'élément le supporte, sinon `aria-required` (Select/SelectCheckbox sur le `<button>`, RichText sur le wrapper éditeur, Upload sur le champ visible). - `MalioSiteSelector` **exclu** volontairement (segmented control, pas de label de champ). ### Sanitisation email (`MalioInputEmail`) - Suppression de **tous les espaces** à la saisie (pas de masque). - Nouvelle prop opt-in `lowercase` (défaut `false`) : normalise en minuscules à la frappe (cohérent RG-1.21 Starseed). - Garde défensive curseur : l'API de sélection est interdite sur `type="email"` → repositionnement best-effort sans jamais lever. - La validation de format reste à la couche `error`. ### Docs & playground - `COMPONENTS.md` (doc `required` cohérente + note famille + `lowercase`) et `CHANGELOG.md` mis à jour. - Exemples playground `required` et email `lowercase` ajoutés. ## Test plan - [x] Suite complète : 42 fichiers / 771 tests verts - [x] Lint : 0 erreur - [x] Tests `aria-required` sur Select/SelectCheckbox/RichText - [ ] Vérif visuelle playground : astérisque 16px dans le label, email qui retire les espaces / minuscule Spec & plan : `docs/superpowers/specs/` et `docs/superpowers/plans/`. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Reviewed-on: #60 Co-authored-by: tristan <tristan@yuno.malio.fr> Co-committed-by: tristan <tristan@yuno.malio.fr>
234 lines
7.9 KiB
TypeScript
234 lines
7.9 KiB
TypeScript
import {describe, expect, it} from 'vitest'
|
||
import {mount} from '@vue/test-utils'
|
||
import type {DefineComponent} from 'vue'
|
||
import InputAmount from './InputAmount.vue'
|
||
|
||
type InputAmountProps = {
|
||
id?: string
|
||
label?: string
|
||
name?: string
|
||
autocomplete?: string
|
||
modelValue?: string | null
|
||
inputClass?: string
|
||
labelClass?: string
|
||
groupClass?: string
|
||
required?: boolean
|
||
maxLength?: number | string
|
||
minLength?: number | string
|
||
disabled?: boolean
|
||
readonly?: boolean
|
||
hint?: string
|
||
error?: string
|
||
success?: string
|
||
iconName?: string
|
||
iconPosition?: 'left' | 'right'
|
||
iconSize?: string | number
|
||
iconColor?: string
|
||
reserveMessageSpace?: boolean
|
||
}
|
||
|
||
const InputAmountForTest = InputAmount as DefineComponent<InputAmountProps>
|
||
|
||
const mountInputAmount = (props: InputAmountProps = {}) =>
|
||
mount(InputAmountForTest, {
|
||
props,
|
||
global: {
|
||
stubs: {
|
||
IconifyIcon: {
|
||
template: '<span data-test="icon" v-bind="$attrs" />',
|
||
},
|
||
},
|
||
},
|
||
})
|
||
|
||
describe('MalioInputAmount', () => {
|
||
it('renders as a text input with decimal input mode', () => {
|
||
const wrapper = mountInputAmount()
|
||
|
||
expect(wrapper.get('input').attributes('type')).toBe('text')
|
||
expect(wrapper.get('input').attributes('inputmode')).toBe('decimal')
|
||
})
|
||
|
||
it('renders the default icon with muted styling', () => {
|
||
const wrapper = mountInputAmount()
|
||
|
||
expect(wrapper.get('[data-test="icon"]').exists()).toBe(true)
|
||
expect(wrapper.get('[data-test="icon"]').classes()).toContain('text-m-muted')
|
||
expect(wrapper.get('[data-test="icon"]').classes()).toContain('right-[10px]')
|
||
})
|
||
|
||
it('generates an amount-specific id', () => {
|
||
const wrapper = mountInputAmount({label: 'Montant'})
|
||
|
||
const inputId = wrapper.get('input').attributes('id')
|
||
|
||
expect(inputId?.startsWith('malio-input-amount-')).toBe(true)
|
||
expect(wrapper.get('label').attributes('for')).toBe(inputId)
|
||
})
|
||
|
||
it('applies the provided input classes', () => {
|
||
const wrapper = mountInputAmount({inputClass: 'text-right'})
|
||
|
||
expect(wrapper.get('input').classes()).toContain('text-right')
|
||
})
|
||
|
||
it('links hint text through aria-describedby', () => {
|
||
const wrapper = mountInputAmount({hint: 'Saisissez un montant'})
|
||
|
||
const inputId = wrapper.get('input').attributes('id')
|
||
|
||
expect(wrapper.get('input').attributes('aria-describedby')).toBe(`${inputId}-describedby`)
|
||
expect(wrapper.get('p').attributes('id')).toBe(`${inputId}-describedby`)
|
||
})
|
||
|
||
it('sets aria-invalid and describedby when showing an error', () => {
|
||
const wrapper = mountInputAmount({error: 'Montant invalide'})
|
||
|
||
const inputId = wrapper.get('input').attributes('id')
|
||
|
||
expect(wrapper.get('input').attributes('aria-invalid')).toBe('true')
|
||
expect(wrapper.get('input').attributes('aria-describedby')).toBe(`${inputId}-describedby`)
|
||
expect(wrapper.get('p.text-m-danger').text()).toBe('Montant invalide')
|
||
})
|
||
|
||
it('keeps dots as the decimal separator on input', async () => {
|
||
const wrapper = mountInputAmount({modelValue: ''})
|
||
|
||
await wrapper.get('input').setValue('12.5')
|
||
|
||
expect(wrapper.emitted('update:modelValue')?.[0]).toEqual(['12.5'])
|
||
expect(wrapper.get('input').element.value).toBe('12.5')
|
||
})
|
||
|
||
it('accepts commas but normalizes them to dots', async () => {
|
||
const wrapper = mountInputAmount({modelValue: ''})
|
||
|
||
await wrapper.get('input').setValue('0012,345abc')
|
||
|
||
expect(wrapper.emitted('update:modelValue')?.[0]).toEqual(['12.34'])
|
||
expect(wrapper.get('input').element.value).toBe('12.34')
|
||
})
|
||
|
||
it('normalizes a leading decimal separator', async () => {
|
||
const wrapper = mountInputAmount({modelValue: ''})
|
||
|
||
await wrapper.get('input').setValue(',5')
|
||
|
||
expect(wrapper.emitted('update:modelValue')?.[0]).toEqual(['0.5'])
|
||
expect(wrapper.get('input').element.value).toBe('0.5')
|
||
})
|
||
|
||
it('keeps the normalized decimal value on blur', async () => {
|
||
const wrapper = mountInputAmount()
|
||
const input = wrapper.get('input')
|
||
|
||
await input.setValue('12.5')
|
||
await input.trigger('blur')
|
||
|
||
expect(wrapper.emitted('update:modelValue')).toEqual([['12.5']])
|
||
expect(input.element.value).toBe('12.5')
|
||
})
|
||
|
||
it('keeps integer values unchanged on blur', async () => {
|
||
const wrapper = mountInputAmount()
|
||
const input = wrapper.get('input')
|
||
|
||
await input.setValue('12')
|
||
await input.trigger('blur')
|
||
|
||
expect(wrapper.emitted('update:modelValue')).toEqual([['12']])
|
||
expect(input.element.value).toBe('12')
|
||
})
|
||
|
||
it('keeps an empty value empty on blur', async () => {
|
||
const wrapper = mountInputAmount()
|
||
const input = wrapper.get('input')
|
||
|
||
await input.setValue('')
|
||
await input.trigger('blur')
|
||
|
||
expect(wrapper.emitted('update:modelValue')).toEqual([['']])
|
||
expect(input.element.value).toBe('')
|
||
})
|
||
|
||
it('supports icon positioning on the left', () => {
|
||
const wrapper = mountInputAmount({
|
||
label: 'Montant',
|
||
iconPosition: 'left',
|
||
})
|
||
|
||
expect(wrapper.get('[data-test="icon"]').classes()).toContain('left-[10px]')
|
||
expect(wrapper.get('input').classes()).toContain('!pl-11')
|
||
expect(wrapper.get('label').classes()).toContain('left-11')
|
||
})
|
||
|
||
it('shows primary icon color on focus', async () => {
|
||
const wrapper = mountInputAmount()
|
||
|
||
await wrapper.get('input').trigger('focus')
|
||
|
||
expect(wrapper.get('[data-test="icon"]').classes()).toContain('text-m-primary')
|
||
})
|
||
|
||
it('shows black icon color when filled and unfocused', () => {
|
||
const wrapper = mountInputAmount({modelValue: '12,50'})
|
||
|
||
expect(wrapper.get('[data-test="icon"]').classes()).toContain('text-black')
|
||
})
|
||
|
||
it('affiche l\'astérisque quand required est vrai', () => {
|
||
const wrapper = mountInputAmount({label: 'Champ', required: true})
|
||
expect(wrapper.find('[data-test="required-mark"]').exists()).toBe(true)
|
||
})
|
||
|
||
it('n\'affiche pas l\'astérisque par défaut', () => {
|
||
const wrapper = mountInputAmount({label: 'Champ'})
|
||
expect(wrapper.find('[data-test="required-mark"]').exists()).toBe(false)
|
||
})
|
||
|
||
it('readonly : bordure noire même vide, pas de grow/bleu', () => {
|
||
const wrapper = mountInputAmount({label: 'Champ', readonly: true})
|
||
const field = wrapper.get('input')
|
||
expect(field.classes()).toContain('border-black')
|
||
expect(field.classes()).not.toContain('border-m-muted')
|
||
expect(field.classes()).not.toContain('focus:border-m-primary')
|
||
expect(field.classes()).not.toContain('grow-height')
|
||
})
|
||
|
||
it('readonly vide : label gris, pas de bleu', () => {
|
||
const wrapper = mountInputAmount({label: 'Champ', readonly: true})
|
||
expect(wrapper.get('label').classes()).not.toContain('peer-focus:text-m-primary')
|
||
expect(wrapper.get('label').classes()).toContain('text-m-muted')
|
||
})
|
||
|
||
it('readonly vide : icône en text-m-muted', () => {
|
||
const wrapper = mountInputAmount({label: 'Champ', readonly: true})
|
||
expect(wrapper.get('[data-test="icon"]').classes()).toContain('text-m-muted')
|
||
})
|
||
|
||
it('readonly rempli : label noir et icône noire', () => {
|
||
const wrapper = mountInputAmount({label: 'Champ', readonly: true, modelValue: '12.50'})
|
||
expect(wrapper.get('label').classes()).toContain('text-black')
|
||
expect(wrapper.get('[data-test="icon"]').classes()).toContain('text-black')
|
||
})
|
||
|
||
it('réserve l’espace message par défaut même sans message', () => {
|
||
const wrapper = mountInputAmount({label: 'Champ'})
|
||
const msg = wrapper.find('[id$="-describedby"]')
|
||
expect(msg.exists()).toBe(true)
|
||
expect(msg.classes()).toContain('min-h-[1rem]')
|
||
})
|
||
|
||
it('reserveMessageSpace=false sans message : pas de ligne réservée', () => {
|
||
const wrapper = mountInputAmount({label: 'Champ', reserveMessageSpace: false})
|
||
expect(wrapper.find('[id$="-describedby"]').exists()).toBe(false)
|
||
})
|
||
|
||
it('reserveMessageSpace=false avec message : ligne rendue sans min-h', () => {
|
||
const wrapper = mountInputAmount({label: 'Champ', reserveMessageSpace: false, error: 'Erreur'})
|
||
const msg = wrapper.find('[id$="-describedby"]')
|
||
expect(msg.exists()).toBe(true)
|
||
expect(msg.classes()).not.toContain('min-h-[1rem]')
|
||
})
|
||
})
|