Files
malio-layer-ui/app/components/malio/time/Time.vue
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

269 lines
7.2 KiB
Vue

<template>
<div>
<div :class="mergedGroupClass">
<label
v-if="label"
:for="hoursInputId"
:class="mergedLabelClass"
>
{{ label }}<MalioRequiredMark v-if="required" />
</label>
<div class="flex items-center gap-2">
<input
:id="hoursInputId"
:name="hoursName"
autocomplete="off"
:class="mergedInputClass('hours')"
:required="required"
:disabled="disabled"
:readonly="readonly"
:aria-invalid="!!error"
:aria-describedby="describedBy"
:value="hoursValue"
v-bind="attrs"
type="text"
inputmode="numeric"
placeholder="00"
maxlength="2"
@input="onHoursInput"
@focus="activeField = 'hours'"
@blur="onHoursBlur"
>
<span class="text-[18px] text-black">:</span>
<input
ref="minutesInputRef"
:id="minutesInputId"
:name="minutesName"
autocomplete="off"
:class="mergedInputClass('minutes')"
:required="required"
:disabled="disabled"
:readonly="readonly"
:aria-invalid="!!error"
:aria-describedby="describedBy"
:value="minutesValue"
v-bind="attrs"
type="text"
inputmode="numeric"
placeholder="00"
maxlength="2"
@input="onMinutesInput"
@focus="activeField = 'minutes'"
@blur="onMinutesBlur"
>
</div>
</div>
<p
v-if="reserveMessageSpace || hint || error || success"
:id="`${inputId}-describedby`"
:class="[
hasError
? 'text-m-danger'
: hasSuccess
? 'text-m-success'
: 'text-m-muted',
'mt-1 ml-[2px] text-xs',
reserveMessageSpace ? 'min-h-[1rem]' : '',
]"
>
{{ error || success || hint }}
</p>
</div>
</template>
<script setup lang="ts">
import {computed, nextTick, ref, useAttrs, useId, watch} from 'vue'
import {twMerge} from 'tailwind-merge'
import MalioRequiredMark from '../shared/RequiredMark.vue'
defineOptions({name: 'MalioTime', inheritAttrs: false})
const props = withDefaults(
defineProps<{
id?: string
label?: string
name?: string
modelValue?: string | null | undefined
inputClass?: string
labelClass?: string
groupClass?: string
required?: boolean
disabled?: boolean
readonly?: boolean
hint?: string
error?: string
success?: string
reserveMessageSpace?: boolean
}>(),
{
id: '',
name: '',
modelValue: undefined,
label: '',
inputClass: '',
labelClass: '',
groupClass: '',
required: false,
readonly: false,
disabled: false,
hint: '',
error: '',
success: '',
reserveMessageSpace: true,
},
)
const attrs = useAttrs()
const generatedId = useId()
const hoursValue = ref('')
const minutesValue = ref('')
const activeField = ref<'hours' | 'minutes' | null>(null)
const minutesInputRef = ref<HTMLInputElement | null>(null)
const inputId = computed(() => props.id?.toString() || `malio-time-${generatedId}`)
const hoursInputId = computed(() => `${inputId.value}-hours`)
const minutesInputId = computed(() => `${inputId.value}-minutes`)
const hoursName = computed(() => (props.name ? `${props.name}-hours` : ''))
const minutesName = computed(() => (props.name ? `${props.name}-minutes` : ''))
const hasError = computed(() => !!props.error)
const hasSuccess = computed(() => !!props.success && !hasError.value)
const emit = defineEmits<{
(event: 'update:modelValue', value: string): void
}>()
const padSegment = (value: string) => (value === '' ? '' : value.padStart(2, '0'))
const sanitizeDigits = (value: string) =>
value.replace(/\D/g, '').slice(0, 2)
const normalizeHours = (value: string) => {
const digits = sanitizeDigits(value)
if (digits === '') return ''
if (Number.parseInt(digits, 10) > 23) return '23'
return digits
}
const normalizeMinutes = (value: string) => {
const digits = sanitizeDigits(value)
if (digits === '') return ''
if (Number.parseInt(digits, 10) > 59) return '59'
return digits
}
const parseTimeValue = (value: string | null | undefined) => {
if (!value) return {hours: '', minutes: ''}
const [rawHours = '', rawMinutes = ''] = value.split(':')
return {
hours: normalizeHours(rawHours),
minutes: normalizeMinutes(rawMinutes),
}
}
const syncFromModelValue = (value: string | null | undefined) => {
if (activeField.value) return
const parsedValue = parseTimeValue(value)
hoursValue.value = parsedValue.hours
minutesValue.value = parsedValue.minutes
}
watch(() => props.modelValue, syncFromModelValue, {immediate: true})
const describedBy = computed(() =>
(props.hint || hasError.value || hasSuccess.value) ? `${inputId.value}-describedby` : undefined,
)
const mergedGroupClass = computed(() =>
twMerge(
'relative mt-4 flex w-full items-center',
props.groupClass,
),
)
const mergedLabelClass = computed(() =>
twMerge(
'mt-px mr-4 cursor-pointer text-black text-[18px]',
hasError.value ? 'text-m-danger' : '',
hasSuccess.value ? 'text-m-success' : '',
props.disabled ? 'cursor-not-allowed text-black/60' : '',
props.labelClass
),
)
const mergedInputClass = (field: 'hours' | 'minutes') =>
twMerge(
'h-[30px] w-10 border bg-white text-center text-[18px] outline-none rounded-md placeholder:text-m-muted',
props.disabled ? 'cursor-not-allowed text-black/60 border-m-muted' : 'cursor-text',
hasError.value
? 'border-m-danger focus:border-m-danger'
: hasSuccess.value
? 'border-m-success focus:border-m-success'
: activeField.value === field
? 'border-m-primary text-m-primary'
: 'border-black text-black',
props.inputClass,
)
const emitCurrentValue = (pad = false) => {
if (!hoursValue.value && !minutesValue.value) {
emit('update:modelValue', '')
return
}
const h = pad ? padSegment(hoursValue.value || '0') : (hoursValue.value || '00')
const m = pad ? padSegment(minutesValue.value || '0') : (minutesValue.value || '00')
emit('update:modelValue', `${h}:${m}`)
}
const onHoursInput = (event: Event) => {
const target = event.target as HTMLInputElement
const normalizedValue = normalizeHours(target.value)
hoursValue.value = normalizedValue
target.value = normalizedValue
emitCurrentValue()
if (normalizedValue.length === 2) {
nextTick(() => minutesInputRef.value?.focus())
}
}
const onMinutesInput = (event: Event) => {
const target = event.target as HTMLInputElement
const normalizedValue = normalizeMinutes(target.value)
minutesValue.value = normalizedValue
target.value = normalizedValue
emitCurrentValue()
}
const formatFieldOnBlur = (field: 'hours' | 'minutes') => {
if (field === 'hours' && hoursValue.value) {
hoursValue.value = padSegment(hoursValue.value)
}
if (field === 'minutes' && minutesValue.value) {
minutesValue.value = padSegment(minutesValue.value)
}
emitCurrentValue(true)
}
const onHoursBlur = () => {
formatFieldOnBlur('hours')
activeField.value = null
}
const onMinutesBlur = () => {
formatFieldOnBlur('minutes')
activeField.value = null
}
</script>