@cnamts/synapse 1.0.21 → 1.0.23

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

@@ -0,0 +1,152 @@
+import { describe, it, expect } from 'vitest'
+import { mount } from '@vue/test-utils'
+import SyIconButton from '../SyIconButton.vue'
+
+const globalStubs = {
+	global: {
+		stubs: {
+			'v-btn': {
+				template: '<button :aria-label="ariaLabel" :disabled="disabled" @click="$emit(\'click\', $event)"><slot></slot></button>',
+				props: ['ariaLabel', 'disabled', 'size', 'variant', 'icon'],
+				emits: ['click'],
+			},
+			'SyIcon': {
+				template: '<span class="sy-icon" :aria-hidden="decorative ? true : undefined"></span>',
+				props: ['icon', 'color', 'size', 'decorative'],
+			},
+		},
+	},
+}
+
+describe('SyIconButton', () => {
+	it('renders correctly', () => {
+		const wrapper = mount(SyIconButton, {
+			props: {
+				icon: 'mdi-close',
+				label: 'Fermer',
+			},
+			...globalStubs,
+		})
+
+		expect(wrapper.html()).toMatchSnapshot()
+	})
+
+	it('renders a button with the correct aria-label', () => {
+		const wrapper = mount(SyIconButton, {
+			props: {
+				icon: 'mdi-close',
+				label: 'Fermer',
+			},
+			...globalStubs,
+		})
+
+		const button = wrapper.find('button')
+		expect(button.exists()).toBe(true)
+		expect(button.attributes('aria-label')).toBe('Fermer')
+	})
+
+	it('renders the icon as decorative (aria-hidden="true")', () => {
+		const wrapper = mount(SyIconButton, {
+			props: {
+				icon: 'mdi-close',
+				label: 'Fermer',
+			},
+			...globalStubs,
+		})
+
+		const icon = wrapper.find('.sy-icon')
+		expect(icon.exists()).toBe(true)
+		expect(icon.attributes('aria-hidden')).toBe('true')
+	})
+
+	it('renders the correct icon', () => {
+		const wrapper = mount(SyIconButton, {
+			props: {
+				icon: 'mdi-close',
+				label: 'Fermer',
+			},
+			...globalStubs,
+		})
+
+		expect(wrapper.find('.sy-icon').exists()).toBe(true)
+	})
+
+	it('disables the button when disabled prop is true', () => {
+		const wrapper = mount(SyIconButton, {
+			props: {
+				icon: 'mdi-close',
+				label: 'Fermer',
+				disabled: true,
+			},
+			...globalStubs,
+		})
+
+		expect(wrapper.find('button').attributes('disabled')).toBeDefined()
+	})
+
+	it('emits click-icon-button when clicked', async () => {
+		const wrapper = mount(SyIconButton, {
+			props: {
+				icon: 'mdi-close',
+				label: 'Fermer',
+			},
+			...globalStubs,
+		})
+
+		await wrapper.find('button').trigger('click')
+		expect(wrapper.emitted('click-icon-button')).toBeTruthy()
+	})
+
+	it('passes the size prop to v-btn', () => {
+		const wrapper = mount(SyIconButton, {
+			props: {
+				icon: 'mdi-close',
+				label: 'Fermer',
+				size: 'large',
+			},
+			...globalStubs,
+		})
+
+		expect(wrapper.html()).toMatchSnapshot()
+	})
+
+	it('passes the color prop to SyIcon', () => {
+		const wrapper = mount(SyIconButton, {
+			props: {
+				icon: 'mdi-close',
+				label: 'Fermer',
+				color: 'primary',
+			},
+			...globalStubs,
+		})
+
+		expect(wrapper.html()).toMatchSnapshot()
+	})
+
+	it('passes the variant prop to v-btn', () => {
+		const wrapper = mount(SyIconButton, {
+			props: {
+				icon: 'mdi-close',
+				label: 'Fermer',
+				variant: 'outlined',
+			},
+			...globalStubs,
+		})
+
+		expect(wrapper.html()).toMatchSnapshot()
+	})
+
+	it('uses text variant by default', () => {
+		const wrapper = mount(SyIconButton, {
+			props: {
+				icon: 'mdi-close',
+				label: 'Fermer',
+			},
+			...globalStubs,
+		})
+
+		const button = wrapper.find('button')
+		expect(button.exists()).toBe(true)
+		expect(wrapper.html()).toMatchSnapshot()
+	})
+})

package/src/components/Customs/SyIconButton/tests/__snapshots__/SyIconButton.spec.ts.snap

@@ -0,0 +1,61 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`SyIconButton > passes the color prop to SyIcon 1`] = `
+<button
+  aria-label="Fermer"
+  class="rounded-circle"
+>
+  <span
+    aria-hidden="true"
+    class="sy-icon"
+  ></span>
+</button>
+`;
+
+exports[`SyIconButton > passes the size prop to v-btn 1`] = `
+<button
+  aria-label="Fermer"
+  class="rounded-circle"
+>
+  <span
+    aria-hidden="true"
+    class="sy-icon"
+  ></span>
+</button>
+`;
+
+exports[`SyIconButton > passes the variant prop to v-btn 1`] = `
+<button
+  aria-label="Fermer"
+  class="rounded-circle"
+>
+  <span
+    aria-hidden="true"
+    class="sy-icon"
+  ></span>
+</button>
+`;
+
+exports[`SyIconButton > renders correctly 1`] = `
+<button
+  aria-label="Fermer"
+  class="rounded-circle"
+>
+  <span
+    aria-hidden="true"
+    class="sy-icon"
+  ></span>
+</button>
+`;
+
+exports[`SyIconButton > uses text variant by default 1`] = `
+<button
+  aria-label="Fermer"
+  class="rounded-circle"
+>
+  <span
+    aria-hidden="true"
+    class="sy-icon"
+  ></span>
+</button>
+`;

package/src/components/Customs/SyPagination/SyPagination.stories.ts

@@ -41,6 +41,10 @@ const meta: Meta<typeof SyPagination> = {
 		'append': {
 			description: 'Slot pour ajouter du contenu après la pagination',
 		},
+		'headingLevel': {
+			control: { type: 'select' },
+			options: [1, 2, 3, 4, 5, 6],
+		},
 	},
 } as Meta<typeof SyPagination>
 
@@ -57,6 +61,7 @@ export const Default: Story = {
 		},
 	},
 	args: {
+		'headingLevel': 2,
 		'modelValue': 1,
 		'pages': 5,
 		'visible': 5,
@@ -74,6 +79,7 @@ export const Default: Story = {
 				<SyPagination
 					v-model="currentPage"
 					:pages="args.pages"
+					:headingLevel="args.headingLevel"
 					:visible="args.visible"
 					:label="args.label"
 					@update:model-value="args['onUpdate:modelValue']"
@@ -92,6 +98,7 @@ export const ManyPages: Story = {
 		},
 	},
 	args: {
+		'headingLevel': 2,
 		'modelValue': 5,
 		'pages': 20,
 		'visible': 5,
@@ -111,6 +118,7 @@ export const ManyPages: Story = {
 					:pages="args.pages"
 					:visible="args.visible"
 					:label="args.label"
+					:headingLevel="args.headingLevel"
 					@update:model-value="args['onUpdate:modelValue']"
 				/>
 			</div>
@@ -127,6 +135,7 @@ export const CustomButtons: Story = {
 		},
 	},
 	args: {
+		'headingLevel': 2,
 		'modelValue': 5,
 		'pages': 20,
 		'visible': 5,
@@ -145,6 +154,7 @@ export const CustomButtons: Story = {
 					v-model="currentPage"
 					:pages="args.pages"
 					:visible="args.visible"
+					:headingLevel="args.headingLevel"
 					:label="args.label"
 					@update:model-value="args['onUpdate:modelValue']"
 				>
@@ -175,6 +185,7 @@ export const Slots: Story = {
 		},
 	},
 	args: {
+		'headingLevel': 2,
 		'modelValue': 3,
 		'pages': 10,
 		'visible': 5,
@@ -186,11 +197,11 @@ export const Slots: Story = {
 			const currentPage = ref(args.modelValue)
 			const itemsPerPage = 10
 			const totalItems = 100
-
+			const headingLevel = 2
 			const startItem = computed(() => (currentPage.value - 1) * itemsPerPage + 1)
 			const endItem = computed(() => Math.min(currentPage.value * itemsPerPage, totalItems))
 
-			return { args, currentPage, totalItems, startItem, endItem }
+			return { args, currentPage, totalItems, startItem, endItem, headingLevel }
 		},
 		template: `
 			<div>
@@ -199,6 +210,7 @@ export const Slots: Story = {
 					:pages="args.pages"
 					:visible="args.visible"
 					:label="args.label"
+					:headingLevel="args.headingLevel"
 					@update:model-value="args['onUpdate:modelValue']"
 				>
 					<template #prepend>

package/src/components/Customs/SyPagination/SyPagination.vue

@@ -1,8 +1,9 @@
 <script setup lang="ts">
 	import { computed, ref } from 'vue'
+	import SyHeading from '@/components/SyHeading/SyHeading.vue'
 
 	// Props definition
-	const props = defineProps<{
+	const props = withDefaults(defineProps<{
 		/**
 		 * Current page number
 		 */
@@ -23,7 +24,18 @@
 		 * ID of the element controlled by this pagination
 		 */
 		ariaControls?: string
-	}>()
+		/**
+		 * Heading level for the pagination label (for accessibility)
+		 */
+		headingLevel?: 1 | 2 | 3 | 4 | 5 | 6
+
+	}>(), {
+		pages: undefined,
+		visible: undefined,
+		label: undefined,
+		ariaControls: undefined,
+		headingLevel: 2,
+	})
 
 	// Default values for optional props
 	const visiblePages = computed(() => props.visible || 5)
@@ -187,12 +199,13 @@
 			:aria-labelledby="uniqueId"
 			:aria-controls="ariaControls"
 		>
-			<h2
+			<SyHeading
 				:id="uniqueId"
 				class="d-sr-only"
+				:level="headingLevel"
 			>
 				{{ `${label}` }}
-			</h2>
+			</SyHeading>
 			<ul class="list">
 				<!-- First page button (optional) -->
 				<li v-if="$slots['first-page']">
@@ -371,8 +384,8 @@
 				display: inline-block;
 				padding: 0.5rem 0.75rem;
 				text-decoration: none;
-				color: tokens.$primary-base;
-				border: 1px solid tokens.$primary-base;
+				color: var(--pagination-color);
+				border: 1px solid var(--pagination-border);
 				border-radius: 4px;
 				transition: all 0.2s ease;
 				font-size: 0.875rem;
@@ -380,17 +393,19 @@
 
 				&:hover,
 				&:focus {
-					background-color: rgba(tokens.$primary-base, 0.1);
+					background-color: var(--pagination-focused-background-color);
 				}
 
 				&[aria-current='page'] {
-					background-color: tokens.$primary-base;
+					background-color: var(--pagination-background-color);
 					color: white;
 					font-weight: 500;
 				}
 
 				&.disabled {
-					color: rgb(0 0 0 / 60%); /* Increased from 40% to 60% for better contrast */
+					color: rgb(0 0 0 / 60%);
+
+					/* Increased from 40% to 60% for better contrast */
 					border-color: rgb(0 0 0 / 20%);
 					pointer-events: none;
 				}
@@ -399,7 +414,7 @@
 					border: none;
 					pointer-events: none;
 					display: inline-block;
-					color: tokens.$primary-base;
+					color: var(--pagination-ellipsis);
 					padding: 0.6rem;
 				}
 			}

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

@@ -1,10 +1,81 @@
-import { Meta, Story } from '@storybook/addon-docs';
-import * as SyPagination from '../SyPagination.stories';
-import '@/stories/styles/shared.css';
+import { Meta, Primary } from '@storybook/blocks';
+import * as SyPaginationStories from '../SyPagination.stories';
+import AccessibilityIcon from '@/common/imgs/accessibility-svgrepo-com.svg';
+import {
+	AccessibilityGuideLayout,
+	CriteriaSection,
+	CriteriaCard,
+	DemoSection,
+	BestPracticesSection,
+	ResourcesSection,
+} from '@/stories/accessibility/AccessibilityGuideLayout.mdx';
 
-<Meta of={SyPagination} />
+<Meta of={SyPaginationStories} />
 
-<div className="header">
-  <h1>Accessibilité</h1>
-  <p>Cette page sera bientôt disponible</p>
-</div>
+<AccessibilityGuideLayout
+	componentName="SyPagination"
+	iconSrc={AccessibilityIcon}
+>
+	<CriteriaSection>
+<CriteriaCard icon="🧩" title="Niveau de titre configurable via la prop headingLevel">
+  <ul>
+    <li>Le niveau du titre (h1 à h6) est défini grâce à la propriété <strong>headingLevel</strong> déclarée dans le composant. Si aucune valeur n’est fournie, le composant applique par défaut un titre de niveau h2, défini dans l’implémentation du composant.</li>
+      <code>&lt;SyPagination
+          :heading-level="2" /&gt; </code>
+    
+    <li><strong>Accessibilité</strong> : Permet que la hiérarchie entre les titres soit pertinente (critère 9.1.1 RGAA) </li>
+  </ul>
+</CriteriaCard>
+		<CriteriaCard icon="🔍" title="Structure sémantique">
+			<ul>
+				<li><strong>Zone de navigation</strong> : utilisation de <code>&lt;nav&gt;</code> et <code>&lt;ul&gt;</code> pour structurer la pagination.</li>
+				<li><strong>Nom accessible</strong> : titre <code>&lt;h2&gt;</code> caché (classe <code>d-sr-only</code>) relié au <code>nav</code> via <code>aria-labelledby</code>; libellé personnalisable avec la prop <code>label</code> (par défaut «&nbsp;Pagination&nbsp;»).</li>
+				<li><strong>Association au contenu</strong> : prise en charge de <code>aria-controls</code> pour relier la pagination à la zone paginée.</li>
+				<li><strong>Page active</strong> : l’attribut <code>aria-current="page"</code> est appliqué au lien de la page courante.</li>
+			</ul>
+		</CriteriaCard>
+
+		<CriteriaCard icon="⌨️" title="Navigation clavier">
+			<ul>
+				<li><strong>Tabulation</strong> : l’ordre de tab suit la séquence logique (Précédent → numéros → Suivant).</li>
+				<li><strong>Activation</strong> : les liens de pagination se déclenchent à l’Entrée (ou Espace selon le navigateur).</li>
+				<li><strong>Focus visible</strong> : le focus natif reste apparent sur les liens (<code>&lt;a&gt;</code>).</li>
+			</ul>
+		</CriteriaCard>
+
+		<CriteriaCard icon="📱" title="États et retours d’information">
+			<ul>
+				<li><strong>Boutons indisponibles</strong> : <code>aria-disabled="true"</code> est ajouté sur «&nbsp;Précédent&nbsp;» / «&nbsp;Suivant&nbsp;» / premières/dernières pages lorsque non actionnables.</li>
+				<li><strong>Ellipses non interactives</strong> : les séparateurs «&nbsp;…&nbsp;» sont rendus non cliquables pour éviter la confusion.</li>
+			</ul>
+		</CriteriaCard>
+
+		<CriteriaCard icon="🎨" title="Personnalisation accessible">
+			<ul>
+				<li>Slots pour <code>first-page</code>, <code>previous</code>, <code>next</code>, <code>last-page</code> et <code>page-number</code> afin d’adapter les libellés ou ajouter des icônes.</li>
+				<li>Possibilité d’ajouter du contexte via <code>prepend</code> / <code>append</code> (ex. compteur «&nbsp;Éléments 21-40 sur 200&nbsp;»).</li>
+			</ul>
+		</CriteriaCard>
+	</CriteriaSection>
+
+	<DemoSection componentName="SyPagination">
+		<Primary />
+	</DemoSection>
+
+	<BestPracticesSection>
+		<ul>
+			<li>Renseigner un <strong>label</strong> explicite (ex. «&nbsp;Pagination des résultats de recherche&nbsp;») pour nommer la navigation.</li>
+			<li>Relier la pagination à la zone de contenu avec <code>aria-controls</code> et un <code>id</code> stable sur le conteneur paginé.</li>
+			<li>Conserver des libellés textuels même si des icônes sont utilisées dans les slots (ou ajouter du texte masqué).</li>
+			<li>S’assurer d’un <strong>contraste suffisant</strong> et d’une taille de cible d’au moins 44px pour les liens.</li>
+			<li>Limiter le nombre de pages affichées en choisissant un <code>visible</code> adapté et en gardant des libellés courts.</li>
+		</ul>
+	</BestPracticesSection>
+
+	<ResourcesSection>
+		<ul>
+			<li><a href="https://www.w3.org/TR/wai-aria-1.2/#navigation" target="_blank" rel="noopener noreferrer">Rôle ARIA « navigation »</a></li>
+			<li><a href="https://www.w3.org/WAI/WCAG21/quickref/#navigation-mechanisms-headings-and-labels" target="_blank" rel="noopener noreferrer">WCAG 2.4 - Mécanismes de navigation</a></li>
+		</ul>
+	</ResourcesSection>
+</AccessibilityGuideLayout>

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

@@ -0,0 +1,53 @@
+// @vitest-environment jsdom
+
+import { afterEach, beforeEach, describe, it } from 'vitest'
+import { mount } from '@vue/test-utils'
+import { axe } from 'vitest-axe'
+import { assertNoA11yViolations } from '@tests/unit/accessibility/axeUtils'
+import SyPagination from '../SyPagination.vue'
+
+describe('SyPagination – accessibility (axe)', () => {
+	beforeEach(() => {
+		const content = document.createElement('div')
+		content.id = 'paginated-content'
+		document.body.appendChild(content)
+	})
+
+	afterEach(() => {
+		document.body.innerHTML = ''
+	})
+
+	const baseProps = {
+		modelValue: 1,
+		pages: 5,
+		visible: 5,
+		ariaControls: 'paginated-content',
+		label: 'Pagination des résultats',
+	}
+
+	it('has no obvious axe violations on default pagination', async () => {
+		const wrapper = mount(SyPagination, {
+			props: baseProps,
+			attachTo: document.body,
+		})
+		const results = await axe(document.body)
+		assertNoA11yViolations(results, 'SyPagination – default')
+		wrapper.unmount()
+	})
+
+	it('has no obvious axe violations with ellipses and disabled controls', async () => {
+		const wrapper = mount(SyPagination, {
+			props: {
+				modelValue: 1,
+				pages: 10,
+				visible: 3,
+				ariaControls: 'paginated-content',
+				label: 'Pagination ellipses',
+			},
+			attachTo: document.body,
+		})
+		const results = await axe(document.body)
+		assertNoA11yViolations(results, 'SyPagination – ellipsis variant')
+		wrapper.unmount()
+	})
+})

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

@@ -6,6 +6,7 @@ describe('SyPagination', () => {
 	it('renders correctly with default props', () => {
 		const wrapper = mount(SyPagination, {
 			props: {
+				headingLevel: 2,
 				modelValue: 1,
 				pages: 10,
 			},
@@ -20,6 +21,7 @@ describe('SyPagination', () => {
 	it('does not render pagination if pages is 1', () => {
 		const wrapper = mount(SyPagination, {
 			props: {
+				headingLevel: 2,
 				modelValue: 1,
 				pages: 1,
 			},
@@ -31,6 +33,7 @@ describe('SyPagination', () => {
 	it('emits update:modelValue when page is changed', async () => {
 		const wrapper = mount(SyPagination, {
 			props: {
+				headingLevel: 2,
 				modelValue: 1,
 				pages: 10,
 			},
@@ -58,6 +61,7 @@ describe('SyPagination', () => {
 	it('disables previous button on first page', () => {
 		const wrapper = mount(SyPagination, {
 			props: {
+				headingLevel: 2,
 				modelValue: 1,
 				pages: 10,
 			},
@@ -70,6 +74,7 @@ describe('SyPagination', () => {
 	it('disables next button on last page', () => {
 		const wrapper = mount(SyPagination, {
 			props: {
+				headingLevel: 2,
 				modelValue: 10,
 				pages: 10,
 			},
@@ -82,6 +87,7 @@ describe('SyPagination', () => {
 	it('shows correct aria-current attribute', () => {
 		const wrapper = mount(SyPagination, {
 			props: {
+				headingLevel: 2,
 				modelValue: 3,
 				pages: 10,
 			},
@@ -94,6 +100,7 @@ describe('SyPagination', () => {
 	it('respects visible prop for number of visible pages', () => {
 		const wrapper = mount(SyPagination, {
 			props: {
+				headingLevel: 2,
 				modelValue: 5,
 				pages: 10,
 				visible: 3,
@@ -113,6 +120,7 @@ describe('SyPagination', () => {
 	it('uses custom label when provided', () => {
 		const wrapper = mount(SyPagination, {
 			props: {
+				headingLevel: 2,
 				modelValue: 1,
 				pages: 10,
 				label: 'Test Pagination',
@@ -125,6 +133,7 @@ describe('SyPagination', () => {
 	it('sets aria-controls when provided', () => {
 		const wrapper = mount(SyPagination, {
 			props: {
+				headingLevel: 2,
 				modelValue: 1,
 				pages: 10,
 				ariaControls: 'test-content',
@@ -137,6 +146,7 @@ describe('SyPagination', () => {
 	it('uses d-sr-only class for screen reader text', () => {
 		const wrapper = mount(SyPagination, {
 			props: {
+				headingLevel: 2,
 				modelValue: 1,
 				pages: 10,
 			},
@@ -149,6 +159,7 @@ describe('SyPagination', () => {
 	it('shows start ellipsis when current page is far from first page', () => {
 		const wrapper = mount(SyPagination, {
 			props: {
+				headingLevel: 2,
 				modelValue: 8, // Current page far from first page
 				pages: 10,
 				visible: 3, // Small visible count to ensure ellipsis appears
@@ -163,6 +174,7 @@ describe('SyPagination', () => {
 	it('shows both ellipses when current page is in the middle of a large range', () => {
 		const wrapper = mount(SyPagination, {
 			props: {
+				headingLevel: 2,
 				modelValue: 10, // Middle page
 				pages: 20,
 				visible: 3, // Small visible count to ensure ellipsis appears

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

@@ -185,6 +185,10 @@ const meta = {
 			description: 'Texte d\'aide affiché sous le champ',
 			control: 'text',
 		},
+		'maxlength': {
+			description: 'Nombre maximal de caractères autorisés dans le champ',
+			control: { type: 'text' },
+		},
 		'loading': {
 			description: 'Affiche un indicateur de chargement',
 			control: 'boolean',