❌

Vue lecture

Liens externes accessibles

En recréant ce carnet de zéro, les liens s'ouvraient à même la page, sans créer de nouvel onglet/fenêtre.

Est-ce qu'ajouter un attribut target="_blank" sur des liens hypertextes absolus suffit ? Non, l'exemple du module markdown-it-for-inline ne suffit pas.

J'aimerais :

  • gérer la sécurité avec l'onglet ouvert. Il pourrait être utilisé par des pisteurs, sur la page nouvellement ouverte, par des extensions web verrolées ;
  • informer de la destination aux lecteurs d'écran. La destination étant "un nouvel onglet". Ça correspond au critère 6.1.1 du RGAA ;
  • distinguer visuellement les liens qui ouvrent un nouvel onglet. Même intention, visuelle cette fois.

La sécurité se gère à l'aide des valeurs noopener et noreferrer de l'attribut rel.

Elles préviennent, respectivement, l'accès à la propriété window.opener et à la diffusion de la provenance via l'entête HTTP Referrer.

Ça aide à préserver notre vie privée numérique.


On peut donner du contexte aux lecteurs d'écran dans un label ARIA :

  1. qui repend l'intitulé du lien ;
  2. et qui spécifie l'ouverture dans un nouvel onglet.

L'utilisation du rotor VoiceOver est un bon exemple de cette visibilisation :

Capture d'écran de la navigation par hyperliens dans le rotor VoiceOver

L'antépénultième lien de cette capture d'écran rend explicite l'ouverture dans un nouvel onglet. Ça correspondrait au code HTML suivant :

<a href="..." aria-label="critère 6.1.1 du RGAA (ouvre une nouvelle fenêtre)">
  critère 6.1.1 du RGAA
</a>

Quelques lignes de CSS suffisent à ajouter un symbole visuel à la suite du lien :

a[target="_blank"]::after {
  content: "";
  display: inline-block;
  inline-size: .8em;
  block-size: .8em;
  /* ... */
  background-color: currentColor;
  mask-image: url("data:image/svg+xml;base64, …");
  mask-repeat: no-repeat;
  mask-size: contain;
}

L'utilisation combinée des propriétés background-color et mask-* aident à respecter les proportions de l'image vectorielle et à la détourer aux couleurs du texte du lien.

L'image est encodée directement dans la feuille CSS pour éviter un temps de latence à l'affichage.


C'est bon, nos liens externes sont désormais accessibles. Le code source des liens externes accessibles pour markdown-it (intégré à Build Awesome) est consultable dans le dépôt de ce carnet.

  •  

Émojis accessibles

Je savais déjà que l'utilisation d'émojis dans le texte n'était pas accessible. C'est leur texte alternatif qui est lu au lecteur d'écran. Comme "mains rassemblées" ou folded hands pour l'émoji utilisées pour symboliser un "merci" .

La lecture de l'article making emojis and icons screen reader accessible m'a fait agir dessus sur ce blog avec l'extension markdown-it-emoji.


J'ai suivi la documentation pour rendre l'affichage accessible.

Ainsi, le raccourci textuel :pray: est converti en :

<span class="emoji emoji--pray" aria-hidden="true">🙏</span>

Il a fallu plonger dans les entrailles du fonctionnement de markdown-it pour que chaque émoji existante soit elle aussi, convertie dans un code similaire.

J'ai créé une règle qui est insérée avant l'extension émojis pour convertir chaque émoji (unicode) en raccourci textuel d'émoji :

  1. on parcourt chaque jeton markdown ;\
{
  type: 'inline',
  content: 'Coucou 👋🏻'
}
  1. on vérifie la présence d'une émoji (via leur classe Unicode d'expression régulière) ;
  2. on remplace chaque occurence par son raccourci textuel.\
{
  type: 'inline',
  content: 'Coucou :wave:'
}
  1. qui a son tour rentre dans la moulinette expliquée précédemment\
  <p>Coucou <span class="emoji emoji--wave" aria-hidden="true">👋🏻</span></p>

Le code complet est disponible sur GitHub.


Tout autre émoji décoratif (comme dans cette entrée de journal par exemple) est masquée aux lecteurs d'écran avec aria-hidden="true" :

<h1 id="post-title">
  <span aria-hidden="true">☕️</span>
  Journal : Émojis accessibles
</h1>

Je n'ai pas eu à reprendre les vingt années de contenus pour y arriver. La lecture d'une issue GitHub, d'une proposition de code et le code d'autres extensions markdown m'ont aidé à mettre en place les mécanismes ci-dessus.

  •  

Accessibilité d'abord

Une des motivations à reprendre ce carnet, c'était de proposer une accessibilité exemplaire de tous les contenus.

Enlever les styles de présentation, c'est rendre visibles l'ordre de lecture, la structure de page, l'ordre de tabulation et les intitulés de liens.

Ça m'a aidé à corriger la hiérarchie des titres, éparses et inégales entre les textes produits en vingt ans (!). Mais aussi à sectionner et à étiqueter chacune des zones.

Eleventy / Build Awesome propose deux mécanismes pour se brancher sur le contenu :

De quoi ajouter automatiquement des attributs aux liens, images ou autre qui seraient fastidieux à faire à la main.

  •  

Migration vers Eleventy / Build Awesome

Quelques détails sur le regroupement de trois sites aux contenus différents : texte, supports de présentation et photographies.

Le déplacement des répertoires et fichiers a été minimal. L'effort principal a été de séparer les entrées de journal des billets longs. C'était un travail manuel mais facile et rapide à distinguer.

Une paire de rechercher/remplacer ont suffi à actualiser les métadonnées des fichiers texte.

L'ajout de métadonnées dynamiques était facile grâce au système données calculées.

La génération de vignettes / images aux bonnes dimensions a été facilité avec le module Image. Chose que je faisais initialement en lançant un script maison.

L'organisation en collections rend très facile leur utilisation et ventilation en plusieurs pages. J'avais envie d'aller au-delà de "simples" pages de listing, de mettre en avant les séries d'article et de les regrouper quand et où je voulais.

Au final, au doigt mouillé, je dirais qu'il y a moins de bidouilles et moins de code pour aboutir à un résultat similaire. Et j'avoue, qui renouvelle mon enthousiasme à écrire/publier sur ce carnet.

Comme quoi, un bon stylo outil contribue au plaisir de l'utiliser.

  •  
❌