@cnamts/synapse 0.0.3-alpha → 0.0.5-alpha

package/src/components/SkipLink/Accessibilite.stories.ts

@@ -0,0 +1,167 @@
+import { VExpansionPanels, VExpansionPanel, VExpansionPanelTitle, VExpansionPanelText, VDataTable, VIcon } from 'vuetify/components'
+import type { StoryObj } from '@storybook/vue3'
+import { AccessibiliteItemsIndeterminate, AccessibiliteItemsValidated } from './AccessibiliteItems'
+import { mdiCheckboxMarkedCircle, mdiLink, mdiEye } from '@mdi/js'
+
+const checkIcon = mdiCheckboxMarkedCircle
+const iconEye = mdiEye
+const linkICon = mdiLink
+
+export default {
+	title: 'Composants/Navigation/SkipLink/Accessibilité',
+}
+
+export const AccessibilitePanel: StoryObj = {
+
+	render: () => {
+		return {
+			components: { VExpansionPanels, VExpansionPanel, VExpansionPanelTitle, VExpansionPanelText, VDataTable, VIcon },
+
+			setup() {
+				const icon = checkIcon
+
+				return { AccessibiliteItemsIndeterminate, AccessibiliteItemsValidated, icon, linkICon, iconEye }
+			},
+			template: `
+				<div class="accessibiliteItems" style="display:flex; max-width: none !important;">
+					<v-col cols="6">
+						<div style="display:flex; margin-bottom: 10px; justify-content: space-between; align-items: center;">
+							<h5>{{ AccessibiliteItemsIndeterminate.length }} critères à prendre en charge par le projet</h5>
+							<div style="display: flex; align-items: center;">
+								<v-btn variant="tonal" color="red" size="x-small" style="margin: 4px;font-size: 8px;"
+									   rounded>Tanaguru
+								</v-btn>
+							</div>
+						</div>
+
+						<v-expansion-panels value="opened" multiple>
+							<v-expansion-panel v-for="(item, index) in AccessibiliteItemsIndeterminate" :key="index" style="background-color: rgba(42, 96, 158, 0.1); margin-bottom: 10px;">
+								<v-expansion-panel-title>
+									<VIcon :icon="iconEye" style="margin-right: 5px; color:#5778b7;"/>
+									{{ item.title }}
+								</v-expansion-panel-title>
+								<v-expansion-panel-text>
+									<v-expansion-panels>
+										<v-expansion-panel>
+											<v-expansion-panel-title
+												style="font-weight: bold; font-size: 13px; line-height: 16px;">
+												{{ item.subtitle }}
+											</v-expansion-panel-title>
+											<v-expansion-panel-text>
+												<div v-for="(value, i) in item.items" :key="i">
+													<p style="font-size: 13px;line-height: 16px;">
+														{{ value.precision }}
+													</p>
+													<div v-for="element in value.solution"
+														 style="margin-top:15px; font-size: 13px;line-height: 16px;">
+														<p style="font-weight: bold;">Méthodologie du test : <a
+															href="value.link" target="blank">
+															<VIcon :icon="linkICon"/>
+														</a></p>
+
+														<p>{{ element.info1 }}</p>
+														<p>{{ element.info2 }}</p>
+														<p>{{ element.info3 }}</p>
+
+													</div>
+													<span style="display:flex; justify-content:center; margin-bottom:5px;">______</span>
+												</div>
+											</v-expansion-panel-text>
+										</v-expansion-panel>
+									</v-expansion-panels>
+								</v-expansion-panel-text>
+							</v-expansion-panel>
+						</v-expansion-panels>
+					</v-col>
+					<v-col cols="6">
+						<div style="display:flex; margin-bottom: 10px; justify-content: space-between; align-items: center;">
+							<h5>{{ AccessibiliteItemsValidated.length }} critères pris en charge par l'équipe Design System</h5>
+							<div style="display: flex; align-items: center;">
+								<v-btn variant="tonal" color="red" size="x-small" style="margin: 4px;font-size: 8px;"
+									   rounded>Tanaguru
+								</v-btn>
+							</div>
+						</div>
+						<v-expansion-panels v-if="AccessibiliteItemsValidated.length > 0" value="opened" multiple>
+							<v-expansion-panel 
+								v-for="(item, index) in AccessibiliteItemsValidated"
+								:key="index" style="background-color: rgba(53,135,0,0.1); margin-bottom: 10px;">
+								<v-expansion-panel-title>
+									<VIcon color="green" :icon="icon" style="margin-right: 5px;"/>
+									{{ item.title }}
+								</v-expansion-panel-title>
+								<v-expansion-panel-text>
+									<v-expansion-panels>
+										<v-expansion-panel>
+											<v-expansion-panel-title style="font-weight: bold;font-size: 13px; line-height: 16px;">
+												{{ item.subtitle }}
+											</v-expansion-panel-title>
+											<v-expansion-panel-text>
+												<div v-for="(value, i) in item.items" :key="i">
+													<p style="font-size: 13px;line-height: 16px;">
+														{{ value.precision }}
+													</p>
+													<div v-for="element in value.solution"
+														 style="margin-top:15px; font-size: 13px;line-height: 16px;">
+														<p style="font-weight: bold;">Méthodologie du test : <a
+															href="value.link" target="blank">
+															<VIcon :icon="linkICon"/>
+														</a></p>
+														<p>{{ element.info1 }}</p>
+														<p>{{ element.info2 }}</p>
+														<p>{{ element.info3 }}</p>
+													</div>
+													<span style="display:flex; justify-content:center; margin-bottom:5px;">______</span>
+												</div>
+											</v-expansion-panel-text>
+										</v-expansion-panel>
+									</v-expansion-panels>
+								</v-expansion-panel-text>
+							</v-expansion-panel>
+						</v-expansion-panels>
+						<div style="display: flex;justify-content: center;"><span style="text-align:center;" v-else >Pas de critère d'accessibilité bloquant</span></div>
+					</v-col>
+				</div>
+			`,
+		}
+	},
+	tags: ['!dev'],
+}
+
+export const Legende: StoryObj = {
+	args: {
+		icon: checkIcon,
+	},
+	render: (args) => {
+		return {
+			components: { VIcon },
+			setup() {
+				return { args }
+			},
+			template: `
+			  <p style="color: grey;font-size: 11px; margin-bottom: 12px;">Date de conception: 20/11/2024</p>
+			  <div>
+				<p>Le tableau ci-dessous liste nos recommandations suivant les <a target="blank" style="color:#0C41BD;" href="https://www.numerique.gouv.fr/publications/rgaa-accessibilite/#contenu">catégories du RGAA</a>.</p>
+				<p style="margin-bottom: 12px;font-weight:bold;">Pour rappel le composant seul ne garantie pas
+				  l'accessibilité du site.</p>
+				<div style="font-size: 14px">
+				  <p>Nous avons deux façons de relever les problèmes d'accessibilité des composants :</p>
+				  <div>
+					<v-btn variant="tonal" color="grey" size="x-small" style="margin: 2px;font-size: 8px;" rounded>
+					  Audit
+					</v-btn>
+					Problèmes relevés par le projet
+				  </div>
+				  <div>
+					<v-btn variant="tonal" color="red" size="x-small" style="margin: 2px;font-size: 8px;" rounded>
+					  Tanaguru
+					</v-btn>
+					Problèmes relevés par Tanaguru
+				  </div>
+				</div>
+			  </div>
+            `,
+		}
+	},
+	tags: ['!dev'],
+}

package/src/components/SkipLink/AccessibiliteItems.ts

@@ -0,0 +1,77 @@
+import { ExpertiseLevelEnum } from './constants/ExpertiseLevelEnum'
+
+export const AccessibiliteItemsIndeterminate = [
+	{
+		title: 'Catégorie 6 : Liens',
+		subtitle: ' 6.1 Chaque lien est-il explicite',
+		items: [
+			{
+
+				precision: ' 6.1.1 Chaque lien texte vérifie-t-il une de ces conditions (hors cas particuliers) ? '
+					+ 'L’intitulé de lien seul permet d’en comprendre la fonction et la destination ; '
+					+ 'L’intitulé de lien additionné au contexte du lien permet d’en comprendre la fonction et la destination.',
+				link: 'https://accessibilite.numerique.gouv.fr/methode/criteres-et-tests/#6.1.1',
+				solution: [{
+					info1: '1. Retrouver dans le document les liens texte ;',
+					info2: '2. Pour chaque lien texte, vérifier que ce qui permet d’en comprendre la fonction et la destination est : '
+						+ ' Soit l’intitulé du lien seul, soit le contexte du lien.',
+					info3: '3. Si c’est le cas pour chaque lien texte, le test est validé.',
+				}],
+				expertise: ExpertiseLevelEnum.DEV,
+
+			},
+
+		],
+	},
+	{
+		title: 'Catégorie 10 : Présentation de l\'information',
+		subtitle: '10.8 Pour chaque page web, les contenus cachés ont-ils vocation à être ignorés par les technologies d’assistance',
+		items: [
+			{
+
+				precision: '10.8.1 Le contenu caché a vocation à être ignoré par les technologies d’assistance , il n’a pas vocation à être ignoré par les technologies d’assistance et est rendu restituable par les technologies d’assistance suite à une action de l’utilisateur réalisable au clavier ou par tout dispositif de pointage sur un élément précédent le contenu caché ou suite à un repositionnement du focus dessus',
+				link: 'https://accessibilite.numerique.gouv.fr/methode/criteres-et-tests/#10.8.1',
+				solution: [{
+					info1: '1. Retrouver les contenus cachés (éléments pourvus de l’attribut hidden ou de l’attribut WAI-ARIA aria-hidden, ou bien d’une classe ou d’un ensemble de styles CSS susceptibles de masquer le contenu)',
+					info2: '2. Pour chaque contenu caché, vérifier que :'
+						+ 'Soit le contenu caché a vocation à être ignoré par les technologies d’assistance (un élément statistique de visites par exemple) ;'
+						+ 'Soit le contenu caché n’a pas vocation à être ignoré par les technologies d’assistance, et dans ce cas il est rendu restituable par les technologies d’assistance au moyen :'
+						+ 'Soit d’une action de l’utilisateur réalisable au clavier ou par tout dispositif de pointage sur un élément précédent le contenu caché ;'
+						+ 'Soit d’une fonction de programmation qui repositionne le focus sur le contenu',
+					info3: '3. Si c’est le cas pour chaque contenu caché, le test est validé',
+				}],
+				expertise: ExpertiseLevelEnum.DEV,
+
+			},
+
+		],
+	},
+	{
+		title: 'Catégorie 12 : Navigation',
+		subtitle: '12.9 Dans chaque page web, la navigation ne doit pas contenir de piège au clavier. Cette règle est-elle respectée ?',
+		items: [
+			{
+
+				precision: '12.9.1 Dans chaque page web, chaque élément recevant le focus vérifie-t-il une de ces conditions ? '
+					+ 'Il est possible d’atteindre l’élément suivant ou précédent pouvant recevoir le focus avec la touche de tabulation ;'
+					+ 'L’utilisateur est informé d’un mécanisme fonctionnel permettant d’atteindre au clavier l’élément suivant ou précédent pouvant recevoir le focus.',
+				link: 'https://accessibilite.numerique.gouv.fr/methode/criteres-et-tests/#12.9.1',
+				solution: [{
+					info1: '1. Retrouver dans le document l’ensemble des éléments d’interface susceptibles de recevoir le focus (au moyen de la tabulation ou au moyen d’un script) ;',
+					info2: '2. Pour chaque élément d’interface, vérifier que l’utilisateur peut atteindre l’élément suivant ou précédent pouvant recevoir le focus : '
+						+ 'Soit au moyen de la touche de tabulation (Tab ou Maj+Tab) ;'
+						+ 'Soit au moyen d’une autre interaction clavier dont l’utilisateur est informé (par exemple, les flèches de direction).',
+					info3: '3. Si c’est le cas pour chaque élément d’interface, le test est validé.',
+				}],
+				expertise: ExpertiseLevelEnum.DEV,
+
+			},
+
+		],
+	},
+
+]
+
+export const AccessibiliteItemsValidated = [
+
+]

package/src/components/SkipLink/SkipLink.stories.ts

@@ -2,7 +2,7 @@ import type { Meta, StoryObj } from '@storybook/vue3'
 import SkipLink from './SkipLink.vue'
 
 const meta = {
-	title: 'Components/SkipLink',
+	title: 'Composants/Navigation/SkipLink',
 	component: SkipLink,
 	argTypes: {
 		default: {
@@ -20,6 +20,30 @@ export default meta
 type Story = StoryObj<typeof meta>
 
 export const Default: Story = {
+	parameters: {
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `<template>
+	<div class="pa-8">
+		<p>Pour afficher le composant, cliquez ici et appuyer sur <kbd>Tab</kbd>.</p>
+		<SkipLink 
+			label="Aller au contenu principal"
+			target="https://cnam-design-system.netlify.app/?path=/docs/components-skiplink--docs#main" 
+		/>
+	</div>
+</template>
+				`,
+			},
+			{
+				name: 'Script',
+				code: `<script setup lang="ts">
+	import SkipLink from '@cnamts/synapse'
+</script>
+				`,
+			},
+		],
+	},
 	args: {
 		target: 'https://cnam-design-system.netlify.app/?path=/docs/components-skiplink--docs#main',
 	},
@@ -45,6 +69,31 @@ export const Default: Story = {
 }
 
 export const WithSlot: Story = {
+	parameters: {
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `<template>
+	<div class="pa-8">
+		<p>Pour afficher le composant, cliquez ici et appuyer sur <kbd>Tab</kbd>.</p>
+		<SkipLink target="https://cnam-design-system.netlify.app/?path=/docs/components-skiplink--docs#main">
+			<template #default>
+				<b>lorem ipsum</b>
+			</template>
+		</SkipLink>
+	</div>
+</template>
+				`,
+			},
+			{
+				name: 'Script',
+				code: `<script setup lang="ts">
+	import SkipLink from '@cnamts/synapse'
+</script>
+				`,
+			},
+		],
+	},
 	args: {
 		target: 'https://cnam-design-system.netlify.app/?path=/docs/components-skiplink--docs#main',
 		default: '<b>lorem ipsum</b>',

package/src/components/SkipLink/constants/ExpertiseLevelEnum.ts

@@ -0,0 +1,4 @@
+export enum ExpertiseLevelEnum {
+	DEV = 'dev',
+	DESIGN = 'design',
+}

package/src/components/SocialMediaLinks/SocialMediaLinks.mdx

@@ -6,10 +6,41 @@ import * as SocialMediaLinksStories from './SocialMediaLinks.stories.ts';
 
 # SocialMediaLinks
 
-Le composant `SocialMediaLinks` est utilisé pour afficher des liens de reseaux sociaux dans le componant `Footer`.
+Le composant `SocialMediaLinks` est utilisé pour afficher des liens de réseaux sociaux dans le composant `Footer`.
 
 <Canvas of={SocialMediaLinksStories.Default}  />
 
 # API
 
-<Controls of={SocialMediaLinksStories.Default} />
+<Controls of={SocialMediaLinksStories.Default} />
+
+# Exemple d'utilisation
+
+<Source dark code={`
+<script setup lang="ts">
+import SocialMediaLinks from '@cnamts/synapse'
+import { mdiFacebook, mdiLinkedin, mdiTwitter } from '@mdi/js'
+
+const links = [
+	{
+		icon: mdiLinkedin,
+		name: 'LinkedIn',
+		href: 'https://www.linkedin.com/company/assurance-maladie/',
+	},
+	{
+		icon: mdiFacebook,
+		name: 'Facebook',
+		href: 'https://twitter.com/Assur_Maladie',
+	},
+	{
+		icon: mdiTwitter,
+		name: 'Twitter',
+		href: 'https://twitter.com/Assur_Maladie',
+	},
+]
+</script>
+
+<template>
+    <SocialMediaLinks :links="links" />
+</template>
+`} />

package/src/components/SocialMediaLinks/SocialMediaLinks.stories.ts

@@ -3,7 +3,7 @@ import type { Meta, StoryObj } from '@storybook/vue3'
 import { mdiFacebook, mdiLinkedin, mdiTwitter } from '@mdi/js'
 
 const meta = {
-	title: 'Components/SocialMediaLinks',
+	title: 'Composants/Navigation/SocialMediaLinks',
 	component: SocialMediaLinks,
 	parameters: {
 		layout: 'fullscreen',
@@ -37,6 +37,43 @@ export default meta
 type Story = StoryObj<typeof meta>
 
 export const Default: Story = {
+	parameters: {
+		sourceCode: [
+			{
+				name: 'Template',
+				code: `<template>
+	<SocialMediaLinks :links="links" />
+</template>
+				`,
+			},
+			{
+				name: 'Script',
+				code: `<script setup lang="ts">
+	import SocialMediaLinks from '@cnamts/synapse'
+	import { mdiFacebook, mdiLinkedin, mdiTwitter } from '@mdi/js'
+	
+	const links = [
+		{
+			icon: mdiLinkedin,
+			name: 'LinkedIn',
+			href: 'https://www.linkedin.com/company/assurance-maladie/',
+		},
+		{
+			icon: mdiFacebook,
+			name: 'Facebook',
+			href: 'https://twitter.com/Assur_Maladie',
+		},
+		{
+			icon: mdiTwitter,
+			name: 'Twitter',
+			href: 'https://twitter.com/Assur_Maladie',
+		},
+	]
+</script>
+				`,
+			},
+		],
+	},
 	args: {
 		links: [
 			{

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

@@ -10,7 +10,7 @@ const vuetify = createVuetify({
 	directives,
 })
 
-describe('SocialMediaLinks.vue', () => {
+describe('SocialMediaLinks', () => {
 	let wrapper: VueWrapper
 
 	afterEach(() => {

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

@@ -1,12 +1,12 @@
 // Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
 
-exports[`SocialMediaLinks.vue > renders correctly with default props 1`] = `
+exports[`SocialMediaLinks > renders correctly with default props 1`] = `
 "<div data-v-9d3df26f="" class="d-flex flex-column"><span data-v-9d3df26f="" class="vd-social-media-links-label text-subtitle-2 text--primary">Suivez-nous :</span>
   <ul data-v-9d3df26f="" class="d-flex max-width-none"></ul>
 </div>"
 `;
 
-exports[`SocialMediaLinks.vue > renders correctly with provided links 1`] = `
+exports[`SocialMediaLinks > renders correctly with provided links 1`] = `
 "<div data-v-9d3df26f="" class="d-flex flex-column"><span data-v-9d3df26f="" class="vd-social-media-links-label text-subtitle-2 text--primary">Suivez-nous :</span>
   <ul data-v-9d3df26f="" class="d-flex max-width-none">
     <li data-v-9d3df26f=""><a data-v-9d3df26f="" class="v-btn v-btn--icon v-theme--light v-btn--density-default v-btn--size-default v-btn--variant-text" href="https://twitter.com" id="social-btn-0" target="_blank" rel="noopener noreferrer" aria-label="Lien vers Twitter"><span class="v-btn__overlay"></span><span class="v-btn__underlay"></span>

package/src/components/SubHeader/SubHeader.mdx

@@ -0,0 +1,31 @@
+import {Controls, Canvas, Meta, Source} from '@storybook/blocks';
+
+import * as SubHeaderStories from './SubHeader.stories';
+
+<Meta of={SubHeaderStories} />
+
+# SubHeader
+
+Le composant `SubHeader` est utilisé pour afficher un bloc d’informations sous l’en-tête principale.
+
+<Canvas of={SubHeaderStories.Default}  />
+
+# API
+
+<Controls of={SubHeaderStories.Default} />
+
+# Exemple d'utilisation
+
+<Source dark code={`
+<script setup lang="ts">
+import SubHeader from '@cnamts/synapse'
+</script>
+
+<template>
+    <SubHeader
+		back-btn-text="Back"
+		title-text="Paul Dupont"
+        sub-title-text="1 69 08 75 125 456 75"
+	/>
+</template>
+`} />