Files
malio-layer-ui/app/components/malio/input/InputTextArea.test.ts
T
tristan 887ebdebd7 feat(ui) : required cohérent + astérisque label + sanitisation email (MUI-41) (#60)
## 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>
2026-06-04 06:42:19 +00:00

237 lines
8.1 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import {describe, expect, it} from 'vitest'
import {mount} from '@vue/test-utils'
import type {DefineComponent} from 'vue'
import InputTextArea from './InputTextArea.vue'
type InputTextAreaProps = {
id?: string
label?: string
name?: string
autocomplete?: string
modelValue?: string | null
size?: number | string
textInput?: string
textLabel?: string
required?: boolean
maxLength?: number
showCounter?: boolean
disabled?: boolean
readonly?: boolean
hint?: string
error?: string
success?: string
rounded?: string
reserveMessageSpace?: boolean
}
const InputTextAreaForTest = InputTextArea as DefineComponent<InputTextAreaProps>
describe('MalioInputTextArea', () => {
it('renders the initial textarea value', () => {
const wrapper = mount(InputTextAreaForTest, {
props: {modelValue: 'initial textarea value'},
})
expect(wrapper.get('textarea').element.value).toBe('initial textarea value')
})
it('renders the label text and reuses a provided id', () => {
const wrapper = mount(InputTextAreaForTest, {
props: {id: 'custom-textarea-id', label: 'Description'},
})
expect(wrapper.get('textarea').attributes('id')).toBe('custom-textarea-id')
expect(wrapper.get('label').attributes('for')).toBe('custom-textarea-id')
expect(wrapper.get('label').text()).toBe('Description')
})
it('generates an id when missing', () => {
const wrapper = mount(InputTextAreaForTest, {
props: {label: 'Description'},
})
const textareaId = wrapper.get('textarea').attributes('id')
expect(textareaId?.startsWith('malio-input-textarea-')).toBe(true)
expect(wrapper.get('label').attributes('for')).toBe(textareaId)
})
it('applies name, autocomplete and rows attributes', () => {
const wrapper = mount(InputTextAreaForTest, {
props: {name: 'bio', autocomplete: 'on', size: 4},
})
expect(wrapper.get('textarea').attributes('name')).toBe('bio')
expect(wrapper.get('textarea').attributes('autocomplete')).toBe('on')
expect(wrapper.get('textarea').attributes('rows')).toBe('4')
})
it('sets required, readonly and disabled attributes', () => {
const wrapper = mount(InputTextAreaForTest, {
props: {
required: true,
readonly: true,
disabled: true,
},
})
expect(wrapper.get('textarea').attributes('required')).toBeDefined()
expect(wrapper.get('textarea').attributes('readonly')).toBeDefined()
expect(wrapper.get('textarea').attributes('disabled')).toBeDefined()
expect(wrapper.get('textarea').classes()).toContain('cursor-not-allowed')
})
it('emits update:modelValue on input change', async () => {
const wrapper = mount(InputTextAreaForTest, {
props: {modelValue: ''},
})
await wrapper.get('textarea').setValue('new textarea value')
expect(wrapper.emitted('update:modelValue')?.[0]).toEqual(['new textarea value'])
})
it('shows the character counter when enabled', () => {
const wrapper = mount(InputTextAreaForTest, {
props: {
modelValue: 'hello',
showCounter: true,
maxLength: 20,
},
})
expect(wrapper.get('span.text-xs').text()).toBe('5/20')
expect(wrapper.get('textarea').classes()).toContain('pb-6')
})
it('shows hint message in muted color', () => {
const wrapper = mount(InputTextAreaForTest, {
props: {hint: 'Helpful hint'},
})
expect(wrapper.get('p.text-m-muted').text()).toBe('Helpful hint')
})
it('shows error state on textarea and label', () => {
const wrapper = mount(InputTextAreaForTest, {
props: {
label: 'Description',
error: 'Textarea error',
},
})
expect(wrapper.get('textarea').classes()).toContain('border-m-danger')
expect(wrapper.get('label').classes()).toContain('text-m-danger')
expect(wrapper.get('p.text-m-danger').text()).toBe('Textarea error')
expect(wrapper.get('textarea').attributes('aria-invalid')).toBe('true')
})
it('shows success state on textarea and label', () => {
const wrapper = mount(InputTextAreaForTest, {
props: {
label: 'Description',
success: 'Textarea success',
},
})
expect(wrapper.get('textarea').classes()).toContain('border-m-success')
expect(wrapper.get('label').classes()).toContain('text-m-success')
expect(wrapper.get('p.text-m-success').text()).toBe('Textarea success')
})
it('prioritizes error over success', () => {
const wrapper = mount(InputTextAreaForTest, {
props: {
error: 'Textarea error',
success: 'Textarea success',
},
})
expect(wrapper.get('textarea').classes()).toContain('border-m-danger')
expect(wrapper.find('p.text-m-success').exists()).toBe(false)
expect(wrapper.get('p.text-m-danger').text()).toBe('Textarea error')
})
it('renders as a single root element (works as a single grid item)', () => {
const host = document.createElement('div')
document.body.appendChild(host)
const wrapper = mount(InputTextAreaForTest, {
attachTo: host,
})
// host > div[data-v-app] > component roots
const app = host.firstElementChild as HTMLElement
expect(app.children.length).toBe(1)
wrapper.unmount()
host.remove()
})
it('applies primary scrollbar class on focus', async () => {
const wrapper = mount(InputTextAreaForTest)
expect(wrapper.get('textarea').classes()).not.toContain('textarea-scrollbar-primary')
await wrapper.get('textarea').trigger('focus')
expect(wrapper.get('textarea').classes()).toContain('textarea-scrollbar-primary')
})
it('removes primary scrollbar class on blur', async () => {
const wrapper = mount(InputTextAreaForTest)
await wrapper.get('textarea').trigger('focus')
await wrapper.get('textarea').trigger('blur')
expect(wrapper.get('textarea').classes()).not.toContain('textarea-scrollbar-primary')
})
it('affiche l\'astérisque quand required est vrai', () => {
const wrapper = mount(InputTextAreaForTest, {props: {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 = mount(InputTextAreaForTest, {props: {label: 'Champ'}})
expect(wrapper.find('[data-test="required-mark"]').exists()).toBe(false)
})
it('readonly : bordure noire même vide, pas de bleu', () => {
const wrapper = mount(InputTextAreaForTest, {props: {label: 'Champ', readonly: true}})
const field = wrapper.get('textarea')
expect(field.classes()).toContain('border-black')
expect(field.classes()).not.toContain('border-m-muted')
expect(field.classes()).not.toContain('focus:border-m-primary')
})
it('readonly vide : label gris, pas de bleu focus', () => {
const wrapper = mount(InputTextAreaForTest, {props: {label: 'Champ', readonly: true}})
expect(wrapper.get('label').classes()).toContain('text-m-muted')
// En readonly, pas de couleur primary sur le label
expect(wrapper.get('label').classes()).not.toContain('text-m-primary')
})
it('readonly rempli : label noir', () => {
const wrapper = mount(InputTextAreaForTest, {props: {label: 'Champ', readonly: true, modelValue: 'du texte'}})
expect(wrapper.get('label').classes()).toContain('text-black')
})
it('réserve lespace message par défaut même sans message', () => {
const wrapper = mount(InputTextAreaForTest, {props: {label: 'Champ'}})
const msg = wrapper.find('[data-test="message-line"]')
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 = mount(InputTextAreaForTest, {props: {label: 'Champ', reserveMessageSpace: false}})
expect(wrapper.find('[data-test="message-line"]').exists()).toBe(false)
})
it('reserveMessageSpace=false avec message : ligne rendue sans min-h', () => {
const wrapper = mount(InputTextAreaForTest, {props: {label: 'Champ', reserveMessageSpace: false, error: 'Erreur'}})
const msg = wrapper.find('[data-test="message-line"]')
expect(msg.exists()).toBe(true)
expect(msg.classes()).not.toContain('min-h-[1rem]')
})
})