@cnamts/synapse 1.0.22 → 1.0.23

package/src/components/Customs/SyTextField/accessibilite/Accessibility.mdx

@@ -1,15 +1,73 @@
-import { Meta, Story } from '@storybook/addon-docs';
+import { Meta, Primary } from '@storybook/blocks';
 import * as Stories from '../SyTextField.stories.ts';
-import '@/stories/styles/shared.css';
+import AccessibilityIcon from '@/common/imgs/accessibility-svgrepo-com.svg';
+import {
+	AccessibilityGuideLayout,
+	CriteriaSection,
+	CriteriaCard,
+	DemoSection,
+	BestPracticesSection,
+	ResourcesSection,
+} from '@/stories/accessibility/AccessibilityGuideLayout.mdx';
 
 <Meta of={Stories} />
 
-<div className="header">
-  <h1>Accessibilité</h1>
-</div>
-
-
-<div class="mt-2">
-<p>Rapport d’audit manuel : <a href="/audits/SyTextField.xlsx" style={{ color:'#0C41BD' }}>Voir le rapport</a></p>
+<AccessibilityGuideLayout
+	componentName="SyTextField"
+	iconSrc={AccessibilityIcon}
+	apgHref="https://www.w3.org/WAI/ARIA/apg/patterns/textinput/"
+>
+	<div class="mt-8">
+		<p>Rapport d’audit manuel : <a href="/audits/SyTextField.xlsx" style={{ color:'#0C41BD' }}>Voir le rapport</a></p>
 		<p style={{ color: 'grey', fontSize: '14px', marginTop: '0px' }}>Correctifs associés (<a href="https://github.com/assurance-maladie-digital/design-system-v3/issues/935" target="_blank" style={{color:'#0C41BD'}}>issue #935</a>), (<a href="https://github.com/assurance-maladie-digital/design-system/issues/4028" target="_blank" style={{color:'#0C41BD'}}>issue #4028</a>)</p>
 	</div>
+
+	<CriteriaSection>
+		<CriteriaCard icon="🔍" title="Structure sémantique et attributs">
+			<ul>
+				<li><strong>Élément input natif</strong> : Utilisation de <code>&lt;input&gt;</code> via VTextField pour une sémantique correcte.</li>
+				<li><strong>Labels explicites</strong> : Gestion automatique du <code>aria-label</code> combinant label, préfixe et suffixe. L'attribut <code>aria-required</code> est ajouté si le champ est requis.</li>
+				<li><strong>Association avec les messages</strong> : Implémentation dynamique de <code>aria-describedby</code> pour lier le champ à ses messages d'erreur, d'avertissement ou de succès.</li>
+				<li><strong>Icônes décoratives</strong> : Les icônes de validation (erreur, avertissement, succès) sont masquées aux lecteurs d'écran (<code>role="presentation"</code>) pour éviter la redondance avec les messages textuels.</li>
+			</ul>
+		</CriteriaCard>
+
+		<CriteriaCard icon="⌨️" title="Navigation et interaction clavier">
+			<ul>
+				<li><strong>Focus natif</strong> : Le champ est naturellement focusable via <kbd>Tab</kbd>.</li>
+				<li><strong>Boutons accessibles</strong> : Les icônes interactives (prepend/append) sont des boutons focusables avec des labels descriptifs et gèrent les événements <kbd>Entrée</kbd> et <kbd>Espace</kbd>.</li>
+				<li><strong>Bouton de vidage</strong> : Le bouton "clear" possède un <code>aria-label</code> descriptif ("Vider [label]") et est accessible au clavier.</li>
+				<li><strong>Indicateur de focus</strong> : Styles de focus visibles sur le champ et les icônes interactives.</li>
+			</ul>
+		</CriteriaCard>
+
+		<CriteriaCard icon="🎨" title="Styles et états visuels">
+			<ul>
+				<li><strong>Contrastes garantis</strong> : Couleurs distinctes pour les états erreur (rouge), avertissement (orange) et succès (vert) respectant les critères WCAG.</li>
+				<li><strong>États cohérents</strong> : Changements visuels clairs entre les états normal, erreur, avertissement et succès.</li>
+				<li><strong>Astérisque optionnel</strong> : Possibilité d'afficher un astérisque visuel pour les champs requis via la prop <code>display-asterisk</code>.</li>
+			</ul>
+		</CriteriaCard>
+	</CriteriaSection>
+
+	<DemoSection componentName="SyTextField">
+		<Primary />
+	</DemoSection>
+
+	<BestPracticesSection>
+		<ul>
+			<li><strong>Labels descriptifs</strong> : Utilisez toujours un <code>label</code> clair et concis. Évitez les placeholders comme seuls indicateurs de champ.</li>
+			<li><strong>Messages d'erreur utiles</strong> : Fournissez des messages d'erreur spécifiques qui aident l'utilisateur à corriger sa saisie.</li>
+			<li><strong>Validation appropriée</strong> : Utilisez la validation au blur (<code>isValidateOnBlur</code>) pour ne pas surcharger l'utilisateur pendant la saisie.</li>
+			<li><strong>Évitez les changements de contexte automatiques</strong> : Ne soumettez pas automatiquement le formulaire ou ne changez pas de page lors de la saisie.</li>
+			<li><strong>Préfixes et suffixes accessibles</strong> : Le composant ajoute automatiquement des spans screen-reader-only pour le contenu textuel des préfixes/suffixes.</li>
+		</ul>
+	</BestPracticesSection>
+
+	<ResourcesSection>
+		<ul>
+			<li><a href="https://www.w3.org/WAI/ARIA/apg/patterns/textinput/" target="_blank" rel="noopener noreferrer">Guide des pratiques WAI-ARIA : Champs de texte</a></li>
+			<li><a href="https://accessibilite.numerique.gouv.fr/methode/criteres-et-tests/#11.9" target="_blank" rel="noopener noreferrer">RGAA : Champs de formulaire</a></li>
+		</ul>
+	</ResourcesSection>
+</AccessibilityGuideLayout>

package/src/components/Customs/SyTextField/tests/SyTextField.a11y.spec.ts

@@ -24,4 +24,19 @@ describe('SyTextField – accessibility (axe)', () => {
 			ignoreRules: ['region'],
 		})
 	})
+
+	it('has no obvious axe violations when loading is true', async () => {
+		const wrapper = mount(SyTextField, {
+			props: {
+				label: 'Nom',
+				modelValue: '',
+				loading: true,
+			},
+		})
+
+		const results = await axe(wrapper.element as HTMLElement)
+		assertNoA11yViolations(results, 'SyTextField – loading state', {
+			ignoreRules: ['region'],
+		})
+	})
 })

package/src/components/Customs/SyTextField/tests/SyTextField.spec.ts

@@ -209,6 +209,42 @@ describe('SyTextField', () => {
 		expect(messages.text()).toContain('Attention : Test Field peut contenir une erreur')
 	})
 
+	describe('loading', () => {
+		it('shows progress bar when loading is true', async () => {
+			wrapper = mount(SyTextField, {
+				props: { loading: true, label: 'Nom' },
+			})
+			await wrapper.vm.$nextTick()
+			expect(wrapper.find('.v-progress-linear').exists()).toBe(true)
+		})
+
+		it('does not show progress bar when loading is false', async () => {
+			wrapper = mount(SyTextField, {
+				props: { loading: false, label: 'Nom' },
+			})
+			await wrapper.vm.$nextTick()
+			expect(wrapper.find('.v-progress-linear').exists()).toBe(false)
+		})
+
+		it('sets aria-label with field label when loading', async () => {
+			wrapper = mount(SyTextField, {
+				props: { loading: true, label: 'Nom' },
+			})
+			await wrapper.vm.$nextTick()
+			const bar = wrapper.find('.v-progress-linear')
+			expect(bar.attributes('aria-label')).toBe('Chargement de Nom')
+		})
+
+		it('sets generic aria-label when no label and loading', async () => {
+			wrapper = mount(SyTextField, {
+				props: { loading: true },
+			})
+			await wrapper.vm.$nextTick()
+			const bar = wrapper.find('.v-progress-linear')
+			expect(bar.attributes('aria-label')).toBe('Chargement en cours')
+		})
+	})
+
 	it('maintains input value without validation rules', async () => {
 		wrapper = mount(SyTextField)
 		const input = wrapper.find('input')

package/src/components/DataList/accessibilite/Accessibility.mdx

@@ -1,15 +1,83 @@
-import { Meta, Story } from '@storybook/addon-docs';
-import * as Stories from '../DataList.stories.ts';
-import '@/stories/styles/shared.css';
+import { Meta, Primary } from '@storybook/blocks';
+import * as DataListStories from '../DataList.stories.ts';
+import AccessibilityIcon from '@/common/imgs/accessibility-svgrepo-com.svg';
+import {
+  AccessibilityGuideLayout,
+  CriteriaSection,
+  CriteriaCard,
+  DemoSection,
+  BestPracticesSection,
+  ResourcesSection,
+} from '@/stories/accessibility/AccessibilityGuideLayout.mdx';
 
-<Meta of={Stories} />
+<Meta of={DataListStories}/>
 
-<div className="header">
-  <h1>Accessibilité</h1>
-</div>
+<AccessibilityGuideLayout
+  componentName="DataList"
+  iconSrc={AccessibilityIcon}
+  apgHref="https://www.w3.org/WAI/ARIA/apg/patterns/listbox/"
+>
+  <div class="mt-8">
+    <p>Rapport d'audit manuel : <a href="/audits/DataList.xlsx" style={{ color:'#0C41BD' }}>Voir le rapport</a></p>
+    <p style={{ color: 'grey', fontSize: '14px', marginTop: '0px' }}>Correctifs associés (<a href="https://github.com/assurance-maladie-digital/design-system-v3/issues/4030" target="_blank" style={{color:'#0C41BD'}}>issue #4030</a>)</p>
+  </div>
 
+  <CriteriaSection>
+    <CriteriaCard icon="🔍" title="Structure sémantique des listes">
+      <ul>
+        <li><strong>Élément dl/dt/dd</strong> : Utilisation native des balises de liste de définitions pour une sémantique correcte</li>
+        <li><strong>Section avec titre</strong> : Conteneur <code>&lt;section&gt;</code> avec <code>aria-labelledby</code> lorsque <code>listTitle</code> est fourni</li>
+        <li><strong>Titre personnalisable</strong> : Tag de titre configurable (<code>titleTag</code>) avec ID unique pour l'association ARIA</li>
+      </ul>
+    </CriteriaCard>
 
-<div class="mt-2">
-<p>Rapport d’audit manuel : <a href="/audits/DataList.xlsx" style={{ color:'#0C41BD' }}>Voir le rapport</a></p>
-		<p style={{ color: 'grey', fontSize: '14px', marginTop: '0px' }}>Correctifs associés (<a href="https://github.com/assurance-maladie-digital/design-system-v3/issues/4030" target="_blank" style={{color:'#0C41BD'}}>issue #4030</a>)</p>
-	</div>
+    <CriteriaCard icon="⌨️" title="Navigation et interaction">
+      <ul>
+        <li><strong>Boutons d'action</strong> : Utilisation de <code>VBtn</code> natif pour les actions avec focus clavier correct</li>
+        <li><strong>Focus visible</strong> : Style <code>:focus-visible::after</code> pour une indication claire de navigation</li>
+        <li><strong>Événements accessibles</strong> : Émission d'événements <code>click:item-action</code> pour les interactions</li>
+      </ul>
+    </CriteriaCard>
+
+    <CriteriaCard icon="🎨" title="Icônes et éléments visuels">
+      <ul>
+        <li><strong>Icônes décoratives</strong> : Icônes avec <code>decorative="true"</code> pour masquer aux lecteurs d'écran</li>
+        <li><strong>Contrastes adaptatifs</strong> : Couleurs de label adaptées au thème clair/sombre</li>
+        <li><strong>Chips accessibles</strong> : Utilisation de <code>VChip</code> pour les valeurs avec contraste approprié</li>
+      </ul>
+    </CriteriaCard>
+
+    <CriteriaCard icon="📱" title="Flexibilité et responsive">
+      <ul>
+        <li><strong>Layout adaptable</strong> : Mode <code>row</code> pour les affichages horizontaux avec flexbox</li>
+        <li><strong>Widthable</strong> : Gestion des dimensions via <code>useWidthable</code> pour le responsive</li>
+        <li><strong>Slots personnalisables</strong> : Slots <code>value</code>, <code>action</code>, <code>icon</code> pour une flexibilité maximale</li>
+      </ul>
+    </CriteriaCard>
+  </CriteriaSection>
+
+  <DemoSection componentName="DataList">
+    <Primary />
+  </DemoSection>
+
+  <BestPracticesSection>
+    <ul>
+      <li><strong>Titres descriptifs</strong> : Utilisez toujours <code>listTitle</code> pour fournir un contexte aux listes importantes</li>
+      <li><strong>Labels clairs</strong> : Assurez-vous que les <code>key</code> (labels) sont concis et descriptifs</li>
+      <li><strong>Actions explicites</strong> : Utilisez des verbes d'action clairs pour les boutons ("Modifier", "Supprimer", "Voir")</li>
+      <li><strong>Ordre logique</strong> : Maintenez un ordre cohérent des paires label/valeur dans toute l'application</li>
+      <li><strong>Slots sécurisés</strong> : Préférez le slot <code>value</code> à <code>renderHtmlValue</code> pour le contenu HTML</li>
+      <li><strong>États de chargement</strong> : Utilisez <code>loading</code> avec <code>DataListLoading</code> pour les données asynchrones</li>
+    </ul>
+  </BestPracticesSection>
+
+  <ResourcesSection>
+    <ul>
+      <li><a href="https://www.w3.org/WAI/ARIA/apg/patterns/listbox/" target="_blank" rel="noopener noreferrer">Guide des pratiques WAI-ARIA : Listbox</a></li>
+      <li><a href="https://www.w3.org/WAI/WCAG21/quickref/" target="_blank" rel="noopener noreferrer">Référence rapide WCAG 2.1</a></li>
+      <li><a href="https://accessibilite.numerique.gouv.fr/methode/criteres-et-tests/#11.10" target="_blank" rel="noopener noreferrer">RGAA Critère 11.10 : Listes de définitions</a></li>
+      <li><a href="https://developer.mozilla.org/fr/docs/Web/HTML/Element/dl" target="_blank" rel="noopener noreferrer">MDN : Élément dl - Liste de définitions</a></li>
+    </ul>
+  </ResourcesSection>
+
+</AccessibilityGuideLayout>

package/src/components/DataListGroup/accessibilite/Accessibility.mdx

@@ -1,14 +1,83 @@
-import { Meta, Story } from '@storybook/addon-docs';
-import * as Stories from '../DataListGroup.stories.ts';
-import '@/stories/styles/shared.css';
+import { Meta, Primary } from '@storybook/blocks';
+import * as DataListGroupStories from '../DataListGroup.stories.ts';
+import AccessibilityIcon from '@/common/imgs/accessibility-svgrepo-com.svg';
+import {
+	AccessibilityGuideLayout,
+	CriteriaSection,
+	CriteriaCard,
+	DemoSection,
+	BestPracticesSection,
+	ResourcesSection,
+} from '@/stories/accessibility/AccessibilityGuideLayout.mdx';
 
-<Meta of={Stories} />
+<Meta of={DataListGroupStories}/>
 
-<div className="header">
-  <h1>Accessibilité</h1>
-</div>
-
-<div class="mt-2">
-<p>Rapport d’audit manuel : <a href="/audits/DataListGroup.xlsx" style={{ color:'#0C41BD' }}>Voir le rapport</a></p>
+<AccessibilityGuideLayout
+	componentName="DataListGroup"
+	iconSrc={AccessibilityIcon}
+	apgHref="https://www.w3.org/WAI/ARIA/apg/patterns/listbox/"
+>
+	<div class="mt-8">
+		<p>Rapport d'audit manuel : <a href="/audits/DataListGroup.xlsx" style={{ color:'#0C41BD' }}>Voir le rapport</a></p>
 		<p style={{ color: 'grey', fontSize: '14px', marginTop: '0px' }}>Correctifs associés (<a href="https://github.com/assurance-maladie-digital/design-system-v3/issues/651" target="_blank" style={{color:'#0C41BD'}}>issue #651</a>)</p>
-	</div>
+	</div>
+
+	<CriteriaSection>
+		<CriteriaCard icon="🔍" title="Structure sémantique des groupes">
+			<ul>
+				<li><strong>Élément ul/li</strong> : Utilisation native de liste non ordonnée pour regrouper les DataList</li>
+				<li><strong>Composition sémantique</strong> : Chaque élément contient un DataList avec structure dl/dt/dd héritée</li>
+				<li><strong>Titres hiérarchiques</strong> : Tags de titre configurables (<code>titlesTag</code>) pour chaque sous-liste</li>
+			</ul>
+		</CriteriaCard>
+
+		<CriteriaCard icon="⌨️" title="Navigation et interactions">
+			<ul>
+				<li><strong>Focus séquentiel</strong> : Navigation logique entre les différents groupes et leurs éléments</li>
+				<li><strong>Actions contextualisées</strong> : Événements <code>click:list-item</code> avec indices doubles (dataListIndex, itemIndex)</li>
+				<li><strong>Boutons accessibles</strong> : Actions héritées des DataList avec focus clavier correct</li>
+			</ul>
+		</CriteriaCard>
+
+		<CriteriaCard icon="🎨" title="Mise en page et responsive">
+			<ul>
+				<li><strong>Layout flexbox</strong> : Utilisation de <code>d-flex</code> pour l'affichage horizontal des groupes</li>
+				<li><strong>Largeurs configurables</strong> : <code>itemWidth</code> pour contrôler la taille de chaque groupe</li>
+				<li><strong>Marges négatives</strong> : <code>ma-n4</code> sur le conteneur avec <code>ma-4</code> sur les éléments pour un espacement optimal</li>
+			</ul>
+		</CriteriaCard>
+
+		<CriteriaCard icon="📱" title="États et chargement">
+			<ul>
+				<li><strong>États de chargement</strong> : Propagation de <code>loading</code> à tous les DataList enfants</li>
+				<li><strong>Slots avancés</strong> : Slot <code>item</code> avec contexte enrichi (dataListIndex inclus)</li>
+				<li><strong>Gestion HTML</strong> : Support de <code>renderHtmlValue</code> avec avertissement de dépréciation</li>
+			</ul>
+		</CriteriaCard>
+	</CriteriaSection>
+
+	<DemoSection componentName="DataListGroup">
+		<Primary />
+	</DemoSection>
+
+	<BestPracticesSection>
+		<ul>
+			<li><strong>Groupes cohérents</strong> : Organisez les DataList par thématiques logiques (informations personnelles, coordonnées, etc.)</li>
+			<li><strong>Titres distinctifs</strong> : Utilisez des <code>title</code> uniques et descriptifs pour chaque groupe</li>
+			<li><strong>Largeurs adaptées</strong> : Choisissez <code>itemWidth</code> en fonction du contenu (plus large pour les textes longs)</li>
+			<li><strong>Actions groupées</strong> : Maintenez la cohérence des actions entre les différents groupes</li>
+			<li><strong>États synchronisés</strong> : Utilisez <code>loading</code> au niveau du groupe pour des chargements coordonnés</li>
+			<li><strong>Slots contextuels</strong> : Exploitez le <code>data-list-index</code> dans les slots pour des personnalisations avancées</li>
+		</ul>
+	</BestPracticesSection>
+
+	<ResourcesSection>
+		<ul>
+			<li><a href="https://www.w3.org/WAI/ARIA/apg/patterns/listbox/" target="_blank" rel="noopener noreferrer">Guide des pratiques WAI-ARIA : Listbox</a></li>
+			<li><a href="https://www.w3.org/WAI/WCAG21/quickref/" target="_blank" rel="noopener noreferrer">Référence rapide WCAG 2.1</a></li>
+			<li><a href="https://accessibilite.numerique.gouv.fr/methode/criteres-et-tests/#11.10" target="_blank" rel="noopener noreferrer">RGAA Critère 11.10 : Listes de définitions</a></li>
+			<li><a href="https://developer.mozilla.org/fr/docs/Web/HTML/Element/ul" target="_blank" rel="noopener noreferrer">MDN : Élément ul - Liste non ordonnée</a></li>
+		</ul>
+	</ResourcesSection>
+
+</AccessibilityGuideLayout>

package/src/components/DownloadBtn/tests/DownloadBtn.a11y.spec.ts

@@ -0,0 +1,25 @@
+// @vitest-environment jsdom
+
+import { describe, it } from 'vitest'
+import { mount } from '@vue/test-utils'
+import { axe } from 'vitest-axe'
+import { assertNoA11yViolations } from '@tests/unit/accessibility/axeUtils'
+import DownloadBtn from '../DownloadBtn.vue'
+
+describe('DownloadBtn – accessibility (axe)', () => {
+	it('has no obvious axe violations', async () => {
+		const wrapper = mount(DownloadBtn, {
+			props: {
+				// eslint-disable-next-line @typescript-eslint/no-explicit-any -- deso
+				filePromise: () => Promise.resolve({ data: new Blob(), status: 200, statusText: 'OK', headers: {}, config: {} as any }),
+				fallbackFilename: 'file.pdf',
+			},
+			slots: {
+				default: 'Télécharger',
+			},
+		})
+
+		const results = await axe(wrapper.element as HTMLElement)
+		assertNoA11yViolations(results, 'DownloadBtn – default state')
+	})
+})

package/src/components/ErrorPage/ErrorPage.stories.ts

@@ -75,12 +75,53 @@ export const WithLink: Story = {
 	},
 }
 
-export const WithRole: Story = {
-	args: {
-		...Default.args,
-		role: 'region',
-		uniqueId: 'error-page-region',
+export const CustomIllustration: Story = {
+	decorators: [
+		() => ({ template: '<div style="padding: 20px; background: rgb(231, 236, 245)"><story /></div>' }),
+	],
+	parameters: {
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `
+                <template>
+                    <div style="padding: 20px; background: rgb(231, 236, 245)">
+                        <ErrorPage>
+                            <template #illustration>
+                                <div style="width: 260px; height: 200px; display: grid; place-items: center; border-radius: 12px; background: white; border: 2px dashed #0D419A;">
+                                    <span style="font-weight: 700; color: #0D419A;">Illustration</span>
+                                </div>
+                            </template>
+                        </ErrorPage>
+                    </div>
+                </template>
+                `,
+			},
+			{
+				name: 'Script',
+				code: `
+                <script setup lang="ts">
+                    import { ErrorPage } from '@cnamts/synapse'
+                </script>
+                `,
+			},
+		],
 	},
+	render: () => ({
+		components: { ErrorPage },
+		template: `
+            <ErrorPage>
+                <template #illustration>
+                    <div style="width: 260px; height: 200px; display: grid; place-items: center; border-radius: 12px; background: white; border: 2px dashed #0D419A;">
+                        <span style="font-weight: 700; color: #0D419A;">Illustration</span>
+                    </div>
+                </template>
+            </ErrorPage>
+        `,
+	}),
+}
+
+export const SlotAction: Story = {
 	decorators: [
 		() => ({ template: '<div style="padding: 20px; background: rgb(231, 236, 245)"><story /></div>' }),
 	],
@@ -91,14 +132,19 @@ export const WithRole: Story = {
 				code: `
                 <template>
                     <div style="padding: 20px; background: rgb(231, 236, 245)">
-                        <ErrorPage
-                            role="region"
-                            unique-id="error-page-region"
-                        />
+                        <ErrorPage :hide-btn="true">
+                            <template #action>
+                                <div style="display: flex; gap: 8px; margin-top: 16px;">
+                                    <VBtn href="/" color="primary">Retour à l'accueil</VBtn>
+                                    <VBtn variant="outlined" color="primary">Déconnexion</VBtn>
+                                </div>
+                            </template>
+                        </ErrorPage>
                     </div>
                 </template>
                 `,
-			}, {
+			},
+			{
 				name: 'Script',
 				code: `
                 <script setup lang="ts">
@@ -108,9 +154,22 @@ export const WithRole: Story = {
 			},
 		],
 	},
+	render: () => ({
+		components: { ErrorPage },
+		template: `
+            <ErrorPage :hide-btn="true">
+                <template #action>
+                    <div style="display: flex; gap: 8px; margin-top: 16px;">
+                        <VBtn href="/" color="primary">Retour à l'accueil</VBtn>
+                        <VBtn variant="outlined" color="primary">Déconnexion</VBtn>
+                    </div>
+                </template>
+            </ErrorPage>
+        `,
+	}),
 }
 
-export const CustomIllustration: Story = {
+export const SlotAdditionalContent: Story = {
 	decorators: [
 		() => ({ template: '<div style="padding: 20px; background: rgb(231, 236, 245)"><story /></div>' }),
 	],
@@ -122,10 +181,10 @@ export const CustomIllustration: Story = {
                 <template>
                     <div style="padding: 20px; background: rgb(231, 236, 245)">
                         <ErrorPage>
-                            <template #illustration>
-                                <div style="width: 260px; height: 200px; display: grid; place-items: center; border-radius: 12px; background: white; border: 2px dashed #0D419A;">
-                                    <span style="font-weight: 700; color: #0D419A;">Illustration</span>
-                                </div>
+                            <template #additional-content>
+                                <p style="text-align: center; color: #555;">
+                                    Si le problème persiste, veuillez contacter le support technique.
+                                </p>
                             </template>
                         </ErrorPage>
                     </div>
@@ -146,12 +205,47 @@ export const CustomIllustration: Story = {
 		components: { ErrorPage },
 		template: `
             <ErrorPage>
-                <template #illustration>
-                    <div style="width: 260px; height: 200px; display: grid; place-items: center; border-radius: 12px; background: white; border: 2px dashed #0D419A;">
-                        <span style="font-weight: 700; color: #0D419A;">Illustration</span>
-                    </div>
+                <template #additional-content>
+                    <p style="text-align: center; color: #555;">
+                        Si le problème persiste, veuillez contacter le support technique.
+                    </p>
                 </template>
             </ErrorPage>
         `,
 	}),
 }
+
+export const WithRole: Story = {
+	args: {
+		...Default.args,
+		role: 'region',
+		uniqueId: 'error-page-region',
+	},
+	decorators: [
+		() => ({ template: '<div style="padding: 20px; background: rgb(231, 236, 245)"><story /></div>' }),
+	],
+	parameters: {
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `
+                <template>
+                    <div style="padding: 20px; background: rgb(231, 236, 245)">
+                        <ErrorPage
+                            role="region"
+                            unique-id="error-page-region"
+                        />
+                    </div>
+                </template>
+                `,
+			}, {
+				name: 'Script',
+				code: `
+                <script setup lang="ts">
+                    import { ErrorPage } from '@cnamts/synapse'
+                </script>
+                `,
+			},
+		],
+	},
+}

package/src/components/ErrorPage/ErrorPage.vue

@@ -15,7 +15,7 @@
 		btnHref?: string
 		btnLink?: RouteRecordRaw | string
 		hideBtn?: boolean
-		headingLevel: 1 | 2 | 3 | 4 | 5 | 6
+		headingLevel?: 1 | 2 | 3 | 4 | 5 | 6
 		uniqueId?: string
 		role?: PageAriaRole
 	}>()
@@ -39,7 +39,8 @@
 		:btn-href="props.btnHref"
 		:btn-link="props.btnLink"
 		:hide-btn="props.hideBtn"
-		:unique-id="props.uniqueId"
+		:unique-id="props.uniqueId ?? undefined"
+		:heading-level="props.headingLevel"
 		:role="props.role"
 	>
 		<template
@@ -55,6 +56,20 @@
 				>
 			</slot>
 		</template>
+
+		<template
+			v-if="$slots.action"
+			#action
+		>
+			<slot name="action" />
+		</template>
+
+		<template
+			v-if="$slots['additional-content']"
+			#additional-content
+		>
+			<slot name="additional-content" />
+		</template>
 	</StatusPage>
 </template>
 

package/src/components/ErrorPage/tests/ErrorPage.a11y.spec.ts

@@ -18,4 +18,21 @@ describe('ErrorPage – accessibility (axe)', () => {
 			ignoreRules: ['region'],
 		})
 	})
+
+	it('has no obvious axe violations with #action slot', async () => {
+		const wrapper = mount(ErrorPage, {
+			attachTo: document.body,
+			props: { headingLevel: 1, hideBtn: true },
+			slots: {
+				action: '<button>Retour à l\'accueil</button>',
+			},
+		})
+
+		const results = await axe(document.body)
+		assertNoA11yViolations(results, 'ErrorPage – action slot', {
+			ignoreRules: ['region'],
+		})
+
+		wrapper.unmount()
+	})
 })

package/src/components/ErrorPage/tests/ErrorPage.spec.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest'
-import { shallowMount } from '@vue/test-utils'
+import { mount, shallowMount } from '@vue/test-utils'
 import ErrorPage from '../ErrorPage.vue'
 
 describe('ErrorPage', () => {
@@ -8,4 +8,24 @@ describe('ErrorPage', () => {
 
 		expect(wrapper.html()).toMatchSnapshot()
 	})
+
+	it('renders #action slot content', () => {
+		const wrapper = mount(ErrorPage, {
+			slots: {
+				action: '<button>Retour à l\'accueil</button>',
+			},
+		})
+
+		expect(wrapper.html()).toContain('Retour à l\'accueil')
+	})
+
+	it('renders #additional-content slot content', () => {
+		const wrapper = mount(ErrorPage, {
+			slots: {
+				'additional-content': '<p>Contenu additionnel</p>',
+			},
+		})
+
+		expect(wrapper.html()).toContain('Contenu additionnel')
+	})
 })

package/src/components/ErrorPage/tests/__snapshots__/ErrorPage.spec.ts.snap

@@ -9,6 +9,5 @@ exports[`ErrorPage > renders correctly 1`] = `
   hidebtn="false"
   message="Une erreur est survenue de notre côté, veuillez réessayer plus tard."
   pagetitle="Une erreur est survenue"
-  uniqueid=""
 ></status-page-stub>
 `;