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>
237 lines
8.1 KiB
TypeScript
237 lines
8.1 KiB
TypeScript
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 l’espace 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]')
|
||
})
|
||
})
|