Files
malio-layer-ui/app/components/malio/checkbox/Checkbox.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

195 lines
6.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 Checkbox from './Checkbox.vue'
type CheckboxProps = {
id?: string
label?: string
name?: string
modelValue?: boolean | null
inputClass?: string
labelClass?: string
groupClass?: string
required?: boolean
disabled?: boolean
readonly?: boolean
hint?: string
error?: string
success?: string
reserveMessageSpace?: boolean
}
const CheckboxForTest = Checkbox as DefineComponent<CheckboxProps>
const mountCheckbox = (props: CheckboxProps = {}) =>
mount(CheckboxForTest, {props})
describe('MalioCheckbox', () => {
it('renders a checkbox input', () => {
const wrapper = mountCheckbox()
expect(wrapper.get('input').attributes('type')).toBe('checkbox')
})
it('renders the label text', () => {
const wrapper = mountCheckbox({label: 'Accept terms'})
expect(wrapper.get('label').text()).toContain('Accept terms')
})
it('uses a provided id on input and label', () => {
const wrapper = mountCheckbox({
id: 'checkbox-id',
label: 'Accept terms',
})
expect(wrapper.get('input').attributes('id')).toBe('checkbox-id')
expect(wrapper.get('label').attributes('for')).toBe('checkbox-id')
})
it('generates an id when none is provided', () => {
const wrapper = mountCheckbox({label: 'Accept terms'})
const inputId = wrapper.get('input').attributes('id')
expect(inputId?.startsWith('malio-checkbox-')).toBe(true)
expect(wrapper.get('label').attributes('for')).toBe(inputId)
})
it('applies the name attribute', () => {
const wrapper = mountCheckbox({name: 'terms'})
expect(wrapper.get('input').attributes('name')).toBe('terms')
})
it('reflects the checked state from modelValue', () => {
const wrapper = mountCheckbox({modelValue: true})
expect((wrapper.get('input').element as HTMLInputElement).checked).toBe(true)
})
it('emits update:modelValue when toggled', async () => {
const wrapper = mountCheckbox({modelValue: false})
const input = wrapper.get('input')
await input.setValue(true)
expect(wrapper.emitted('update:modelValue')?.[0]).toEqual([true])
})
it('does not emit when readonly', async () => {
const wrapper = mountCheckbox({
modelValue: true,
readonly: true,
})
const input = wrapper.get('input')
await input.setValue(false)
expect(wrapper.emitted('update:modelValue')).toBeUndefined()
expect((input.element as HTMLInputElement).checked).toBe(true)
})
it('sets disabled and required attributes', () => {
const wrapper = mountCheckbox({
disabled: true,
required: true,
})
expect(wrapper.get('input').attributes('disabled')).toBeDefined()
expect(wrapper.get('input').attributes('required')).toBeDefined()
})
it('shows a hint message and links it with aria-describedby', () => {
const wrapper = mountCheckbox({hint: 'Required field'})
const inputId = wrapper.get('input').attributes('id')
expect(wrapper.get('p').text()).toBe('Required field')
expect(wrapper.get('input').attributes('aria-describedby')).toBe(`${inputId}-describedby`)
})
it('shows an error state and message', () => {
const wrapper = mountCheckbox({
label: 'Accept terms',
error: 'You must accept',
})
expect(wrapper.get('input').attributes('aria-invalid')).toBe('true')
expect(wrapper.get('label').classes()).toContain('text-m-danger')
expect(wrapper.get('p').text()).toBe('You must accept')
})
it('shows success only when there is no error', () => {
const wrapper = mountCheckbox({
success: 'Valid',
error: 'Invalid',
})
expect(wrapper.get('p').text()).toBe('Invalid')
expect(wrapper.get('p').classes()).toContain('text-m-danger')
})
it('shows success styles and message when there is no error', () => {
const wrapper = mountCheckbox({
label: 'Accept terms',
success: 'Valid',
modelValue: true,
})
expect(wrapper.get('label').classes()).toContain('text-m-success')
expect(wrapper.get('p').text()).toBe('Valid')
expect(wrapper.get('p').classes()).toContain('text-m-success')
})
it('uses muted label color when unchecked', () => {
const wrapper = mountCheckbox({label: 'Accept terms', modelValue: false})
expect(wrapper.get('label').classes()).toContain('text-m-muted')
})
it('uses black label color when checked', () => {
const wrapper = mountCheckbox({label: 'Accept terms', modelValue: true})
expect(wrapper.get('label').classes()).toContain('text-black')
})
it('updates label color when toggled without v-model (uncontrolled)', async () => {
const wrapper = mountCheckbox({label: 'Accept terms'})
expect(wrapper.get('label').classes()).toContain('text-m-muted')
await wrapper.get('input').setValue(true)
expect(wrapper.get('label').classes()).toContain('text-black')
})
it('affiche l\'astérisque quand required est vrai', () => {
const wrapper = mountCheckbox({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 = mountCheckbox({label: 'Champ'})
expect(wrapper.find('[data-test="required-mark"]').exists()).toBe(false)
})
it('réserve lespace message par défaut même sans message', () => {
const wrapper = mountCheckbox({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 = mountCheckbox({label: 'Champ', reserveMessageSpace: false})
expect(wrapper.find('[id$="-describedby"]').exists()).toBe(false)
})
it('reserveMessageSpace=false avec message : ligne rendue sans min-h', () => {
const wrapper = mountCheckbox({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]')
})
})