Merge pull request #642 from abraccoippon/feature/fix_a11y_skip_link

feat(DsfrSkipLinks): ♿ Le contenu ciblé par le lien d'évitement prend le focus

Author: laruiss

src/components/DsfrSkipLinks/DsfrSkipLinks.e2e.ts

@@ -0,0 +1,41 @@
+import DsfrSkipLinks from './DsfrSkipLinks.vue'
+import '../../main.css'
+
+const SkipLinksWrapper = {
+  components: {
+    DsfrSkipLinks,
+  },
+
+  data () {
+    return {
+      links: [
+        {
+          id: 'content',
+          text: 'Accéder au contenu',
+        },
+      ],
+    }
+  },
+
+  template: `
+    <DsfrSkipLinks
+        :links="links"
+    />
+    <main id="content" tabindex="0">
+      <h2>Qu'est-ce que le Lorem Ipsum?</h2>
+      <p>Le <strong>Lorem Ipsum</strong> est simplement du faux texte employé dans la composition et la mise en page avant impression. Le Lorem Ipsum est le faux texte standard de l'imprimerie depuis les années 1500, quand un imprimeur anonyme assembla ensemble des morceaux de texte pour réaliser un livre spécimen de polices de texte. Il n'a pas fait que survivre cinq siècles, mais s'est aussi adapté à la bureautique informatique, sans que son contenu n'en soit modifié. Il a été popularisé dans les années 1960 grâce à la vente de feuilles Letraset contenant des passages du Lorem Ipsum, et, plus récemment, par son inclusion dans des applications de mise en page de texte, comme Aldus PageMaker.</p>
+    </main>
+  `,
+}
+
+describe('DsfrSkipLinks', () => {
+  it('should mount a skip link and let main element take the focus', () => {
+    cy.mount(SkipLinksWrapper)
+      .get('a')
+      .contains('Accéder au contenu')
+      .click({ force: true })
+
+    cy.get('main#content')
+      .should('have.focus')
+  })
+})

src/components/DsfrSkipLinks/DsfrSkipLinks.stories.ts

@@ -9,7 +9,8 @@ export default {
   argTypes: {
     links: {
       control: 'object',
-      description: 'Permet de passer le label du lien et l’id de l’élément html ciblée sous forme de tableau d’objets. Chaque objet aura 2 propriétés : `id` et `text`.',
+      description: 'Permet de passer le label du lien et l’id de l’élément html ciblée sous forme de tableau d’objets. Chaque objet aura 2 propriétés : `id` et `text`. <br/>' +
+        ' Il est primordial que les éléments ciblés par les liens d’évitements puissent recevoir le focus (si ce n’est pas le cas nativement, ajouter `tabindex="0"`)',
     },
   },
 }
@@ -29,12 +30,17 @@ export const LiensDEvitement = (args) => ({
   <DsfrSkipLinks
   :links="links"
   />
-  <h2 id="what">Qu'est-ce que le Lorem Ipsum?</h2>
+  <section id="what" tabindex="0">
+    <h2>Qu'est-ce que le Lorem Ipsum?</h2>
     <p>Le <strong>Lorem Ipsum</strong> est simplement du faux texte employé dans la composition et la mise en page avant impression. Le Lorem Ipsum est le faux texte standard de l'imprimerie depuis les années 1500, quand un imprimeur anonyme assembla ensemble des morceaux de texte pour réaliser un livre spécimen de polices de texte. Il n'a pas fait que survivre cinq siècles, mais s'est aussi adapté à la bureautique informatique, sans que son contenu n'en soit modifié. Il a été popularisé dans les années 1960 grâce à la vente de feuilles Letraset contenant des passages du Lorem Ipsum, et, plus récemment, par son inclusion dans des applications de mise en page de texte, comme Aldus PageMaker.</p>
-  </div>
-  <h2 id="why">Pourquoi l'utiliser?</h2>
-  <p>On sait depuis longtemps que travailler avec du texte lisible et contenant du sens est source de distractions, et empêche de se concentrer sur la mise en page elle-même. L'avantage du Lorem Ipsum sur un texte générique comme 'Du texte. Du texte. Du texte.' est qu'il possède une distribution de lettres plus ou moins normale, et en tout cas comparable avec celle du français standard. De nombreuses suites logicielles de mise en page ou éditeurs de sites Web ont fait du Lorem Ipsum leur faux texte par défaut, et une recherche pour 'Lorem Ipsum' vous conduira vers de nombreux sites qui n'en sont encore qu'à leur phase de construction. Plusieurs versions sont apparues avec le temps, parfois par accident, souvent intentionnellement (histoire d'y rajouter de petits clins d'oeil, voire des phrases embarassantes).</p>
-  </div>
+    <p>Le <strong>Lorem Ipsum</strong> est simplement du faux texte employé dans la composition et la mise en page avant impression. Le Lorem Ipsum est le faux texte standard de l'imprimerie depuis les années 1500, quand un imprimeur anonyme assembla ensemble des morceaux de texte pour réaliser un livre spécimen de polices de texte. Il n'a pas fait que survivre cinq siècles, mais s'est aussi adapté à la bureautique informatique, sans que son contenu n'en soit modifié. Il a été popularisé dans les années 1960 grâce à la vente de feuilles Letraset contenant des passages du Lorem Ipsum, et, plus récemment, par son inclusion dans des applications de mise en page de texte, comme Aldus PageMaker.</p>
+    <p>Le <a href="#">Lorem Ipsum</a> est simplement du faux texte employé dans la composition et la mise en page avant impression. Le Lorem Ipsum est le faux texte standard de l'imprimerie depuis les années 1500, quand un imprimeur anonyme assembla ensemble des morceaux de texte pour réaliser un livre spécimen de polices de texte. Il n'a pas fait que survivre cinq siècles, mais s'est aussi adapté à la bureautique informatique, sans que son contenu n'en soit modifié. Il a été popularisé dans les années 1960 grâce à la vente de feuilles Letraset contenant des passages du Lorem Ipsum, et, plus récemment, par son inclusion dans des applications de mise en page de texte, comme Aldus PageMaker.</p>
+  </section>
+  <section id="why" tabindex="0">
+    <h2>Pourquoi l'utiliser?</h2>
+    <p>On sait depuis longtemps que travailler avec du texte lisible et contenant du sens est source de distractions, et empêche de se concentrer sur la mise en page elle-même. L'avantage du Lorem Ipsum sur un texte générique comme 'Du texte. Du texte. Du texte.' est qu'il possède une distribution de lettres plus ou moins normale, et en tout cas comparable avec celle du français standard. De nombreuses suites logicielles de mise en page ou éditeurs de sites Web ont fait du Lorem Ipsum leur faux texte par défaut, et une recherche pour 'Lorem Ipsum' vous conduira vers de nombreux sites qui n'en sont encore qu'à leur phase de construction. Plusieurs versions sont apparues avec le temps, parfois par accident, souvent intentionnellement (histoire d'y rajouter de petits clins d'oeil, voire des phrases embarassantes).</p>
+    <p>Le <a href="#">Lorem Ipsum</a> est simplement du faux texte employé dans la composition et la mise en page avant impression. Le Lorem Ipsum est le faux texte standard de l'imprimerie depuis les années 1500, quand un imprimeur anonyme assembla ensemble des morceaux de texte pour réaliser un livre spécimen de polices de texte. Il n'a pas fait que survivre cinq siècles, mais s'est aussi adapté à la bureautique informatique, sans que son contenu n'en soit modifié. Il a été popularisé dans les années 1960 grâce à la vente de feuilles Letraset contenant des passages du Lorem Ipsum, et, plus récemment, par son inclusion dans des applications de mise en page de texte, comme Aldus PageMaker.</p>
+  </section>
   `,
 
 })

src/components/DsfrSkipLinks/DsfrSkipLinks.vue

@@ -5,8 +5,7 @@ defineProps<{
 
 const scrollMeTo = (elementId: string) => {
   const element = document.getElementById(elementId)
-  const top = element?.offsetTop
-  window.scrollTo(0, top || 0)
+  element?.focus()
 }
 </script>