@cnamts/synapse 1.0.27 → 1.1.0

package/src/components/Customs/SyTextField/Validation/Validation.stories.ts

@@ -0,0 +1,1164 @@
+import type { Meta, StoryObj } from '@storybook/vue3'
+import { ref, watch, onMounted } from 'vue'
+import { VBtn, VForm } from 'vuetify/components'
+import SyTextField from '@/components/Customs/SyTextField/SyTextField.vue'
+import { fn } from '@storybook/test'
+import SyForm from '@/components/Customs/SyForm/SyForm.vue'
+import { getValidationDocumentation } from '@/composables/unifyValidation/documentationValidationProps'
+import type { FieldValidationProps } from '@/composables/unifyValidation/useValidation'
+
+const meta = {
+	title: 'Composants/Formulaires/SyTextField/Validation',
+	component: SyTextField,
+	decorators: [
+		() => ({
+			template: '<div style="padding: 20px;"><story/></div>',
+		}),
+	],
+	parameters: {
+		layout: 'fullscreen',
+		docs: {
+			description: {
+				component: `Exemples de validation pour le composant SyTextField`,
+			},
+		},
+	},
+	argTypes: {
+		...getValidationDocumentation('string'),
+		modelValue: {
+			control: 'text',
+			description: 'Valeur du champ texte',
+		},
+		label: {
+			control: 'text',
+			description: 'Libellé du champ',
+		},
+	},
+	args: {
+		'modelValue': '',
+		'label': 'Nom',
+		'required': false,
+		'errorMessages': null,
+		'warningMessages': null,
+		'successMessages': null,
+		'readonly': false,
+		'disabled': false,
+		'customRules': [],
+		'customWarningRules': [],
+		'customSuccessRules': [],
+		'isValidateOnBlur': true,
+		'onUpdate:modelValue': fn(),
+	},
+} as Meta<typeof SyTextField>
+
+export default meta
+
+type Story = StoryObj<FieldValidationProps>
+
+export const WithError: Story = {
+	parameters: {
+		a11y: {
+			disable: true,
+		},
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `
+				<template>
+					<SyTextField
+						v-model="value"
+						label="Adresse email"
+						:custom-rules="customRules"
+					/>
+				</template>
+				`,
+			},
+			{
+				name: 'Script',
+				code: `
+				<script setup lang="ts">
+					import { ref } from 'vue'
+					import { SyTextField } from '@cnamts/synapse'
+
+					const value = ref('not-an-email')
+
+					const customRules = [
+						{
+							type: 'custom',
+							options: {
+								validate: (value: string) => {
+									const valid = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value)
+									if (!valid) {
+										return false
+									}
+									return true
+								},
+								message: 'L\\'adresse email est invalide.',
+								fieldIdentifier: 'email',
+							},
+						},
+					]
+				</script>
+				`,
+			},
+		],
+	},
+	args: {
+		label: 'Adresse email',
+		modelValue: 'not-an-email',
+		customRules: [
+			{
+				type: 'custom',
+				options: {
+					validate: (value: string) => {
+						const valid = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)
+						if (!valid) {
+							return 'L\'adresse email est invalide.'
+						}
+						return true
+					},
+					fieldIdentifier: 'email',
+				},
+			},
+		],
+	},
+	render: args => ({
+		components: { SyTextField },
+		setup() {
+			const value = ref(args.modelValue)
+			const fieldRef = ref<{ validateOnSubmit: () => Promise<boolean> } | null>(null)
+			watch(() => args.modelValue, (newValue) => {
+				value.value = newValue
+			})
+			onMounted(() => {
+				fieldRef.value?.validateOnSubmit()
+			})
+			return { args, value, fieldRef }
+		},
+		template: `
+			<div class="pa-4">
+				<SyTextField ref="fieldRef" v-bind="args" v-model="value" />
+			</div>
+		`,
+	}),
+}
+
+export const WithWarning: Story = {
+	parameters: {
+		a11y: {
+			disable: true,
+		},
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `
+				<template>
+					<SyTextField
+						v-model="value"
+						label="Nom d'utilisateur"
+						:custom-warning-rules="customWarningRules"
+					/>
+				</template>
+				`,
+			},
+			{
+				name: 'Script',
+				code: `
+				<script setup lang="ts">
+					import { ref } from 'vue'
+					import { SyTextField } from '@cnamts/synapse'
+
+					const value = ref('ab')
+
+					const customWarningRules = [
+						{
+							type: 'custom',
+							options: {
+								validate: (value: string) => value.length >= 3,
+								warningMessage: 'Le nom d\\'utilisateur est très court (moins de 3 caractères).',
+								fieldIdentifier: 'username',
+							},
+						},
+					]
+				</script>
+				`,
+			},
+		],
+	},
+	args: {
+		label: 'Nom d\'utilisateur',
+		modelValue: 'ab',
+		customWarningRules: [
+			{
+				type: 'custom',
+				options: {
+					validate: (value: string) => value.length >= 3,
+					warningMessage: 'Le nom d\'utilisateur est très court (moins de 3 caractères).',
+					fieldIdentifier: 'username',
+				},
+			},
+		],
+	},
+	render: args => ({
+		components: { SyTextField },
+		setup() {
+			const value = ref(args.modelValue)
+			const fieldRef = ref<{ validateOnSubmit: () => Promise<boolean> } | null>(null)
+			watch(() => args.modelValue, (newValue) => {
+				value.value = newValue
+			})
+			onMounted(() => {
+				fieldRef.value?.validateOnSubmit()
+			})
+			return { args, value, fieldRef }
+		},
+		template: `
+			<div class="pa-4">
+				<SyTextField ref="fieldRef" v-bind="args" v-model="value" />
+			</div>
+		`,
+	}),
+}
+
+export const WithSuccess: Story = {
+	parameters: {
+		a11y: {
+			disable: true,
+		},
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `
+				<template>
+					<SyTextField
+						v-model="value"
+						label="Adresse email"
+						:custom-success-rules="customSuccessRules"
+					/>
+				</template>
+				`,
+			},
+			{
+				name: 'Script',
+				code: `
+				<script setup lang="ts">
+					import { ref } from 'vue'
+					import { SyTextField } from '@cnamts/synapse'
+
+					const value = ref('exemple@domaine.fr')
+
+					const customSuccessRules = [
+						{
+							type: 'custom',
+							options: {
+								validate: (value: string) => /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value),
+								successMessage: 'L\\'adresse email est valide.',
+								fieldIdentifier: 'email',
+							},
+						},
+					]
+				</script>
+				`,
+			},
+		],
+	},
+	args: {
+		label: 'Adresse email',
+		modelValue: 'exemple@domaine.fr',
+		showSuccessMessages: true,
+		customSuccessRules: [
+			{
+				type: 'custom',
+				options: {
+					validate: (value: string) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value),
+					successMessage: 'L\'adresse email est valide.',
+					fieldIdentifier: 'email',
+				},
+			},
+		],
+	},
+	render: args => ({
+		components: { SyTextField },
+		setup() {
+			const value = ref(args.modelValue)
+			const fieldRef = ref<{ validateOnSubmit: () => Promise<boolean> } | null>(null)
+			watch(() => args.modelValue, (newValue) => {
+				value.value = newValue
+			})
+			onMounted(() => {
+				fieldRef.value?.validateOnSubmit()
+			})
+			return { args, value, fieldRef }
+		},
+		template: `
+			<div class="pa-4">
+				<SyTextField ref="fieldRef" v-bind="args" v-model="value" />
+			</div>
+		`,
+	}),
+}
+
+export const WithCustomRules: Story = {
+	parameters: {
+		a11y: {
+			disable: true,
+		},
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `
+				<template>
+					<SyTextField
+						v-model="value"
+						label="Mot de passe"
+						type="password"
+						required
+						:custom-rules="customRules"
+					/>
+				</template>
+				`,
+			},
+			{
+				name: 'Script',
+				code: `
+				<script setup lang="ts">
+					import { ref } from 'vue'
+					import { SyTextField } from '@cnamts/synapse'
+
+					const value = ref('')
+
+					const customRules = [
+						{
+							type: 'custom',
+							options: {
+								validate: (value: string) => {
+									if (value.length < 8) return false
+									return true
+								},
+								message: 'Le mot de passe doit contenir au moins 8 caractères.',
+								fieldIdentifier: 'password',
+							},
+						},
+						{
+							type: 'custom',
+							options: {
+								validate: (value: string) => {
+									if (!/[A-Z]/.test(value)) return false
+									return true
+								},
+								message: 'Le mot de passe doit contenir au moins une majuscule.',
+								fieldIdentifier: 'password',
+							},
+						},
+					]
+				</script>
+				`,
+			},
+		],
+	},
+	render: args => ({
+		components: { SyTextField },
+		setup() {
+			const value = ref(args.modelValue)
+			watch(() => args.modelValue, (newValue) => {
+				value.value = newValue
+			})
+
+			const customRules = [
+				{
+					type: 'custom',
+					options: {
+						validate: (value: string) => {
+							if (value.length < 8) return false
+							return true
+						},
+						message: 'Le mot de passe doit contenir au moins 8 caractères.',
+						fieldIdentifier: 'password',
+					},
+				},
+				{
+					type: 'custom',
+					options: {
+						validate: (value: string) => {
+							if (!/[A-Z]/.test(value)) return false
+							return true
+						},
+						message: 'Le mot de passe doit contenir au moins une majuscule.',
+						fieldIdentifier: 'password',
+					},
+				},
+			]
+
+			return { args, value, customRules }
+		},
+		template: `
+			<SyTextField
+				v-bind="args"
+				v-model="value"
+				label="Mot de passe"
+				type="password"
+				required
+				:custom-rules="customRules"
+				width="400px"
+			/>
+		`,
+	}),
+}
+
+export const DisableErrorHandling: Story = {
+	parameters: {
+		a11y: {
+			disable: true,
+		},
+		docs: {
+			description: {
+				story: `
+### Désactivation de la gestion des erreurs
+
+Cette story illustre l'utilisation de la propriété \`disableErrorHandling\` qui permet de désactiver complètement
+la gestion et l'affichage des erreurs dans un champ, même si des règles de validation sont définies.
+`,
+			},
+		},
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `<template>
+  <!-- Champ avec validation normale -->
+  <SyTextField
+    v-model="value1"
+    label="Avec validation"
+    required
+    :custom-rules="customRules"
+  />
+
+  <!-- Champ avec gestion d'erreurs désactivée -->
+  <SyTextField
+    v-model="value2"
+    label="Sans gestion d'erreurs"
+    required
+    disable-error-handling
+    :custom-rules="customRules"
+  />
+</template>`,
+			},
+		],
+	},
+	render: () => ({
+		components: { SyTextField },
+		setup() {
+			const value1 = ref('')
+			const value2 = ref('')
+
+			const customRules = [
+				{
+					type: 'custom',
+					options: {
+						validate: (value: string) => {
+							if (!value || value.trim().length === 0) {
+								return false
+							}
+							return true
+						},
+						message: 'Ce champ est requis.',
+						fieldIdentifier: 'field',
+					},
+				},
+			]
+
+			return { value1, value2, customRules }
+		},
+		template: `
+			<div>
+				<p class="mb-4">Cette démonstration compare un SyTextField standard et un avec <code>disableErrorHandling=true</code>.</p>
+
+				<div style="display: grid; grid-template-columns: 1fr 1fr; gap: 24px; margin-bottom: 16px;">
+					<div>
+						<p class="text-subtitle-2 mb-2">Validation normale</p>
+						<SyTextField
+							v-model="value1"
+							label="Nom"
+							required
+							:custom-rules="customRules"
+						/>
+					</div>
+
+					<div>
+						<p class="text-subtitle-2 mb-2">Sans gestion d'erreurs</p>
+						<SyTextField
+							v-model="value2"
+							label="Nom"
+							required
+							disable-error-handling
+							:custom-rules="customRules"
+						/>
+					</div>
+				</div>
+
+				<div class="mt-4 text-body-2">
+					<p>Instructions :</p>
+					<ol>
+						<li class="ml-4">Cliquez dans un champ puis en dehors pour déclencher la validation</li>
+						<li class="ml-4">Le champ de gauche affichera une erreur requise, mais pas celui de droite</li>
+					</ol>
+				</div>
+			</div>
+		`,
+	}),
+}
+
+/**
+ * Validation déclenchée à chaque frappe (isValidateOnBlur: false).
+ */
+export const ValidateOnInput: Story = {
+	parameters: {
+		docs: {
+			description: {
+				story: `
+### Validation à la saisie
+
+Lorsque \`isValidateOnBlur\` vaut \`false\`, la validation se déclenche à chaque modification
+de la valeur plutôt qu'à la perte de focus. Utile pour un retour immédiat à l'utilisateur.
+`,
+			},
+		},
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `<template>
+	<SyTextField
+		v-model="value"
+		label="Adresse email"
+		required
+		:is-validate-on-blur="false"
+		:custom-rules="[
+			{
+				type: 'custom',
+				options: {
+					message: 'L\\'adresse email est invalide.',
+					validate: (value) => /^[^\\\\s@]+@[^\\\\s@]+\\\\.[^\\\\s@]+$/.test(value),
+				},
+			},
+		]"
+		show-success-messages
+	/>
+</template>`,
+			},
+			{
+				name: 'Script',
+				code: `<script setup lang="ts">
+import { ref } from 'vue'
+import { SyTextField } from '@cnamts/synapse'
+
+const value = ref('')
+</script>`,
+			},
+		],
+	},
+	render: args => ({
+		components: { SyTextField },
+		setup() {
+			const value = ref(args.modelValue)
+			watch(() => args.modelValue, (newValue) => {
+				value.value = newValue
+			})
+			return { args, value }
+		},
+		template: `
+			<div>
+				<p class="mb-4">La validation se déclenche à chaque frappe (<code>isValidateOnBlur="false"</code>).</p>
+				<SyTextField
+					v-model="value"
+					label="Adresse email"
+					required
+					:is-validate-on-blur="false"
+					:custom-rules="[
+						{
+							type: 'custom',
+							options: {
+								message: 'L\\'adresse email est invalide.',
+								validate: (value) => /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value),
+							},
+						},
+					]"
+					show-success-messages
+					width="400px"
+				/>
+			</div>
+		`,
+	}),
+}
+
+/**
+ * Messages de validation injectés directement par le parent (errorMessages, warningMessages, successMessages).
+ */
+export const ExternalMessages: Story = {
+	parameters: {
+		docs: {
+			description: {
+				story: `
+### Messages externes
+
+Les props \`errorMessages\`, \`warningMessages\` et \`successMessages\` permettent d'injecter
+des messages depuis le parent sans déclencher de règle de validation.
+`,
+			},
+		},
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `<template>
+	<SyTextField
+		v-model="value"
+		label="Nom"
+		:show-success-messages="true"
+		:error-messages="errorMessages"
+		:warning-messages="warningMessages"
+		:success-messages="successMessages"
+	/>
+	<div class="mt-4">
+		<VBtn @click="setError">Simuler une erreur</VBtn>
+		<VBtn @click="setWarning" class="ml-2">Simuler un avertissement</VBtn>
+		<VBtn @click="setSuccess" class="ml-2">Simuler un succès</VBtn>
+		<VBtn @click="reset" class="ml-2">Réinitialiser</VBtn>
+	</div>
+</template>`,
+			},
+			{
+				name: 'Script',
+				code: `<script setup lang="ts">
+import { ref } from 'vue'
+import { SyTextField } from '@cnamts/synapse'
+
+const value = ref('')
+const errorMessages = ref<string[] | null>(null)
+const warningMessages = ref<string[] | null>(null)
+const successMessages = ref<string[] | null>(null)
+
+function setError() {
+	errorMessages.value = ['Ce nom est déjà utilisé']
+	warningMessages.value = null
+	successMessages.value = null
+}
+function setWarning() {
+	errorMessages.value = null
+	warningMessages.value = ['Ce nom ressemble à un nom générique']
+	successMessages.value = null
+}
+function setSuccess() {
+	errorMessages.value = null
+	warningMessages.value = null
+	successMessages.value = ['Nom accepté par le serveur']
+}
+function reset() {
+	errorMessages.value = null
+	warningMessages.value = null
+	successMessages.value = null
+}
+</script>`,
+			},
+		],
+	},
+	args: {
+		showSuccessMessages: true,
+	},
+	render: args => ({
+		components: { SyTextField, VBtn },
+		setup() {
+			const value = ref(args.modelValue)
+			watch(() => args.modelValue, (newValue) => {
+				value.value = newValue
+			})
+			const errorMessages = ref<string[] | null>(null)
+			const warningMessages = ref<string[] | null>(null)
+			const successMessages = ref<string[] | null>(null)
+
+			function setError() {
+				errorMessages.value = ['Ce nom est déjà utilisé']
+				warningMessages.value = null
+				successMessages.value = null
+			}
+			function setWarning() {
+				errorMessages.value = null
+				warningMessages.value = ['Ce nom ressemble à un nom générique']
+				successMessages.value = null
+			}
+			function setSuccess() {
+				errorMessages.value = null
+				warningMessages.value = null
+				successMessages.value = ['Nom accepté par le serveur']
+			}
+			function reset() {
+				errorMessages.value = null
+				warningMessages.value = null
+				successMessages.value = null
+			}
+
+			return { args, value, errorMessages, warningMessages, successMessages, setError, setWarning, setSuccess, reset }
+		},
+		template: `
+			<div>
+				<p class="mb-4">
+					Les messages ci-dessous sont injectés par le parent sans déclencher de règle de validation.
+				</p>
+				<SyTextField
+					v-model="value"
+					label="Nom"
+					:show-success-messages="true"
+					:error-messages="errorMessages"
+					:warning-messages="warningMessages"
+					:success-messages="successMessages"
+					width="400px"
+				/>
+				<div class="mt-4 d-flex flex-wrap ga-2 pa-2">
+					<VBtn color="error" @click="setError">Simuler une erreur</VBtn>
+					<VBtn color="warning" @click="setWarning">Simuler un avertissement</VBtn>
+					<VBtn color="success" @click="setSuccess">Simuler un succès</VBtn>
+					<VBtn color="black" @click="reset">Réinitialiser</VBtn>
+				</div>
+			</div>
+		`,
+	}),
+}
+
+export const VFormVuetifyValidation: Story = {
+	parameters: {
+		docs: {
+			description: {
+				story: `
+### Validation de style Vuetify
+
+En passant \`useVuetifyValidation="true"\`, le composant délègue la validation à Vuetify.
+Les règles sont de simples fonctions qui retournent \`true\` si la valeur est valide,
+ou un message d'erreur (chaîne de caractères) sinon — exactement comme avec la prop \`rules\`
+native de Vuetify.
+`,
+			},
+		},
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `<template>
+	<VForm @submit.prevent="handleSubmit">
+		<SyTextField
+			v-model="value"
+			label="Adresse email"
+			:use-vuetify-validation="true"
+			:rules="rules"
+			required
+			:is-validate-on-blur="true"
+		/>
+		<div class="mt-4">
+			<VBtn type="submit" color="primary">Valider</VBtn>
+		</div>
+	</VForm>
+</template>`,
+			},
+			{
+				name: 'Script',
+				code: `<script setup lang="ts">
+import { ref } from 'vue'
+import { SyTextField } from '@cnamts/synapse'
+
+const value = ref('')
+
+const rules = [
+	(value: string) => !!value || 'Ce champ est requis',
+	(value: string) => /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value) || 'L\\'adresse email est invalide',
+]
+
+async function handleSubmit(e) {
+	alert((await e).valid ? 'Valeur valide !' : 'Veuillez corriger les erreurs.')
+}
+</script>`,
+			},
+		],
+	},
+	render: args => ({
+		components: { SyTextField, VBtn, VForm },
+		setup() {
+			const value = ref(args.modelValue)
+			watch(() => args.modelValue, (newValue) => {
+				value.value = newValue
+			})
+
+			const rules = [
+				(value: string) => !!value || 'Ce champ est requis',
+				(value: string) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value) || 'L\'adresse email est invalide',
+			]
+
+			async function handleSubmit(e: Promise<{ valid: boolean }>) {
+				const result = await e
+				alert(result.valid ? 'Valeur valide !' : 'Veuillez corriger les erreurs.')
+			}
+
+			return { args, value, rules, handleSubmit }
+		},
+		template: `
+			<div>
+				<p class="mb-4">
+					Les règles sont des fonctions Vuetify natives <code>(value) => true | 'message'</code>.
+					Cliquez sur <strong>Valider</strong> ou quittez le champ pour déclencher la validation.
+				</p>
+				<VForm @submit.prevent="handleSubmit">
+					<SyTextField
+						v-model="value"
+						label="Adresse email"
+						:use-vuetify-validation="true"
+						:rules="rules"
+						:is-validate-on-blur="true"
+						width="400px"
+					/>
+					<div class="mt-4">
+						<VBtn type="submit" color="primary">Valider</VBtn>
+					</div>
+				</VForm>
+			</div>
+		`,
+	}),
+}
+
+export const SyFormValidation: Story = {
+	parameters: {
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `<template>
+    <SyForm @submit="handleSubmit">
+        <SyTextField
+            v-model="value"
+            label="Adresse email"
+            :custom-rules="customRules"
+			required
+        />
+        <div class="mt-4">
+            <VBtn type="submit" color="primary">Valider</VBtn>
+        </div>
+    </SyForm>
+</template>`,
+			},
+			{
+				name: 'Script',
+				code: `<script setup lang="ts">
+import { ref } from 'vue'
+import { SyTextField, SyForm } from '@cnamts/synapse'
+
+const value = ref('')
+
+const customRules = [
+    {
+        type: 'custom',
+        options: {
+            validate: (value: string) => {
+                if (!value || !/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value)) {
+                    return false
+                }
+                return true
+            },
+            message: 'L\\'adresse email est invalide.',
+            fieldIdentifier: 'email',
+        },
+    },
+]
+
+function handleSubmit(e) {
+    const isValid = e.isValid
+    alert(isValid ? 'Valeur valide !' : 'Veuillez corriger les erreurs.')
+}
+</script>`,
+			},
+		],
+	},
+	render: args => ({
+		components: { SyTextField, VBtn, SyForm },
+		setup() {
+			const value = ref(args.modelValue)
+			watch(() => args.modelValue, (newValue) => {
+				value.value = newValue
+			})
+
+			const customRules = [
+				{
+					type: 'custom',
+					options: {
+						validate: (value: string) => {
+							if (!value || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)) {
+								return false
+							}
+							return true
+						},
+						message: 'L\'adresse email est invalide.',
+						fieldIdentifier: 'email',
+					},
+				},
+			]
+
+			function handleSubmit(e: { isValid: boolean }) {
+				const isValid = e.isValid
+				alert(isValid ? 'Valeur valide !' : 'Veuillez corriger les erreurs.')
+			}
+
+			return { args, value, customRules, handleSubmit }
+		},
+		template: `
+			<div>
+				<SyForm @submit="handleSubmit">
+					<SyTextField
+						v-bind="args"
+						v-model="value"
+						label="Adresse email"
+						:custom-rules="customRules"
+						width="400px"
+						required
+					/>
+					<div class="mt-4">
+						<VBtn type="submit" color="primary">Valider</VBtn>
+					</div>
+				</SyForm>
+			</div>
+		`,
+	}),
+}
+
+export const SyFormVuetifyValidation: Story = {
+	parameters: {
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `<template>
+    <SyForm @submit="handleSubmit">
+        <SyTextField
+            v-model="value"
+            label="Adresse email"
+            :use-vuetify-validation="true"
+            :rules="vuetifyRules"
+        />
+        <div class="mt-4">
+            <VBtn type="submit" color="primary">Valider</VBtn>
+        </div>
+    </SyForm>
+</template>`,
+			},
+			{
+				name: 'Script',
+				code: `<script setup lang="ts">
+import { ref } from 'vue'
+import { SyTextField, SyForm } from '@cnamts/synapse'
+
+const value = ref('')
+
+const vuetifyRules = [
+    (value: string) => !!value || 'Ce champ est requis',
+    (value: string) => /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value) || 'L\\'adresse email est invalide',
+]
+
+function handleSubmit(e) {
+    const isValid = e.isValid
+    alert(isValid ? 'Valeur valide !' : 'Veuillez corriger les erreurs.')
+}
+</script>`,
+			},
+		],
+	},
+	render: args => ({
+		components: { SyTextField, VBtn, SyForm },
+		setup() {
+			const value = ref(args.modelValue)
+			watch(() => args.modelValue, (newValue) => {
+				value.value = newValue
+			})
+
+			const vuetifyRules = [
+				(value: string) => !!value || 'Ce champ est requis',
+				(value: string) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value) || 'L\'adresse email est invalide',
+			]
+
+			function handleSubmit(e: { isValid: boolean }) {
+				const isValid = e.isValid
+				alert(isValid ? 'Valeur valide !' : 'Veuillez corriger les erreurs.')
+			}
+
+			return { args, value, vuetifyRules, handleSubmit }
+		},
+		template: `
+			<div>
+				<SyForm @submit="handleSubmit">
+					<SyTextField
+						v-bind="args"
+						v-model="value"
+						label="Adresse email"
+						:use-vuetify-validation="true"
+						:rules="vuetifyRules"
+						width="400px"
+					/>
+					<div class="mt-4">
+						<VBtn type="submit" color="primary">Valider</VBtn>
+					</div>
+				</SyForm>
+			</div>
+		`,
+	}),
+}
+
+export const VFormValidation: Story = {
+	parameters: {
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `<template>
+	<VForm @submit.prevent="handleSubmit">
+		<SyTextField
+			ref="textFieldRef"
+			v-model="value"
+			label="Adresse email"
+			:custom-rules="[
+				{
+					type: 'custom',
+					options: {
+						validate: (value) => !!value && /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value),
+						message: 'L\\'adresse email est invalide.',
+						fieldIdentifier: 'email',
+					},
+				},
+			]"
+			required
+		/>
+		<VBtn type="submit" color="primary" class="mt-4">Valider</VBtn>
+	</VForm>
+</template>`,
+			},
+			{
+				name: 'Script',
+				code: `<script setup lang="ts">
+import { ref } from 'vue'
+import { SyTextField } from '@cnamts/synapse'
+import { VBtn, VForm } from 'vuetify/components'
+
+const value = ref('')
+const textFieldRef = ref()
+
+async function handleSubmit() {
+	if (textFieldRef.value) {
+		const result = await textFieldRef.value.validateOnSubmit()
+		alert(result ? 'Valeur valide !' : 'Veuillez corriger les erreurs.')
+	}
+}
+</script>`,
+			},
+		],
+	},
+	render: args => ({
+		components: { SyTextField, VBtn, VForm },
+		setup() {
+			const value = ref(args.modelValue)
+			watch(() => args.modelValue, (newValue) => {
+				value.value = newValue
+			})
+			const textFieldRef = ref()
+
+			async function handleSubmit() {
+				if (textFieldRef.value) {
+					const result = await textFieldRef.value.validateOnSubmit()
+					alert(result ? 'Valeur valide !' : 'Veuillez corriger les erreurs.')
+				}
+			}
+
+			return { args, value, textFieldRef, handleSubmit }
+		},
+		template: `
+			<div>
+				<p>Il faut privilégier l'utilisation de <code>SyForm</code> pour bénéficier de intégration.</p>
+				<VForm @submit.prevent="handleSubmit">
+					<SyTextField
+						v-bind="args"
+						ref="textFieldRef"
+						v-model="value"
+						label="Adresse email"
+						:custom-rules="[
+							{
+								type: 'custom',
+								options: {
+									validate: (value) => !!value && /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value),
+									message: 'L\\'adresse email est invalide.',
+									fieldIdentifier: 'email',
+								},
+							},
+						]"
+						required
+						width="400px"
+					/>
+					<VBtn type="submit" color="primary" class="mt-4">Valider</VBtn>
+				</VForm>
+			</div>
+		`,
+	}),
+}
+
+export const EmailValidation: Story = {
+	parameters: {
+		docs: {
+			description: {
+				story: `
+### Validation d'email
+
+Cette story montre un cas d'usage courant : la validation d'une adresse email. Le champ :
+- Est requis
+- Vérifie le format de l'email
+- Affiche un message de succès quand l'email est valide
+`,
+			},
+		},
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `<SyTextField
+	v-model="value"
+	autocomplete="email"
+	label="Email"
+	helpText="Format attendu : nom@domaine.fr"
+	required
+	:customRules="[
+		{
+			type: 'email',
+			options: {
+				message: 'L\\'email n\\'est pas valide',
+				successMessage: 'L\\'email est valide'
+			}
+		}
+	]"
+	showSuccessMessages
+/>`,
+			},
+		],
+	},
+	render: args => ({
+		components: { SyTextField },
+		setup() {
+			const value = ref(args.modelValue)
+			watch(() => args.modelValue, (newValue) => {
+				value.value = newValue
+			})
+			return { args, value }
+		},
+		template: `
+			<SyTextField
+				v-bind="args"
+				v-model="value"
+				label="Email"
+				helpText="Format attendu : nom@domaine.fr"
+				autocomplete="email"
+				required
+				:customRules="[
+					{
+						type: 'email',
+						options: {
+							message: 'L\\'email n\\'est pas valide',
+							successMessage: 'L\\'email est valide'
+						}
+					}
+				]"
+				showSuccessMessages
+			/>
+		`,
+	}),
+}