Skip to content

Commit 38ae1cc

Browse files
jncol1AniortMewenLeHo
authored
Article "Spécifier l'accessibilité de vos designs grâce aux annotations" en FR et EN (#781)
* Update annotations-accessibilite.md Add examples (Link, Button...) * Update annotations-accessibilite.md * Create accessibility-annotations.md * Update annotations-accessibilite.md * Update accessibility-annotations.md * Update annotations-accessibilite.md * Add files via upload * Add files via upload * Add files via upload * Add files via upload * Update accessibility annotations article with new links * Revise accessibility annotations article with updates Updated the date and content to reflect new accessibility annotation guidelines and examples. * Update accessibility annotations article Updated an image reference and improved text clarity regarding accessibility annotations and resources. * Replace accessibility example image in documentation * Update image references in accessibility annotations * Update article annotation fr and en * Update src/en/articles/accessibility-annotations.md OK Co-authored-by: Vincent Aniort <vincent.aniort@orange.com> * Update src/en/articles/accessibility-annotations.md OK Co-authored-by: Vincent Aniort <vincent.aniort@orange.com> * Update src/en/articles/accessibility-annotations.md OK Co-authored-by: Vincent Aniort <vincent.aniort@orange.com> * Update src/en/articles/accessibility-annotations.md OK Co-authored-by: Vincent Aniort <vincent.aniort@orange.com> * Update src/fr/articles/annotations-accessibilite.md OK Co-authored-by: Vincent Aniort <vincent.aniort@orange.com> * Update src/en/articles/accessibility-annotations.md OK Co-authored-by: Vincent Aniort <vincent.aniort@orange.com> * Update src/en/articles/accessibility-annotations.md OK Co-authored-by: Vincent Aniort <vincent.aniort@orange.com> * Update src/fr/articles/annotations-accessibilite.md OK Co-authored-by: Vincent Aniort <vincent.aniort@orange.com> * Update src/en/articles/accessibility-annotations.md * Update src/en/articles/accessibility-annotations.md OK Co-authored-by: Mewen Le Hô <92363071+MewenLeHo@users.noreply.github.com> * Update src/en/articles/accessibility-annotations.md OK Co-authored-by: Mewen Le Hô <92363071+MewenLeHo@users.noreply.github.com> * Update src/en/articles/accessibility-annotations.md OK Co-authored-by: Mewen Le Hô <92363071+MewenLeHo@users.noreply.github.com> * Update src/en/articles/accessibility-annotations.md Ok, merci Mewen pour cette précision, c'est noté. Co-authored-by: Mewen Le Hô <92363071+MewenLeHo@users.noreply.github.com> * Update src/fr/articles/annotations-accessibilite.md OK Co-authored-by: Mewen Le Hô <92363071+MewenLeHo@users.noreply.github.com> * Update src/fr/articles/annotations-accessibilite.md OK Co-authored-by: Mewen Le Hô <92363071+MewenLeHo@users.noreply.github.com> * Update src/fr/articles/annotations-accessibilite.md OK Co-authored-by: Mewen Le Hô <92363071+MewenLeHo@users.noreply.github.com> * Update article update date to February 13, 2026 * Update accessibility annotation update date --------- Co-authored-by: Vincent Aniort <vincent.aniort@orange.com> Co-authored-by: Mewen Le Hô <92363071+MewenLeHo@users.noreply.github.com>
1 parent 2535cb7 commit 38ae1cc

File tree

8 files changed

+88
-16
lines changed

8 files changed

+88
-16
lines changed
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
title: "Specify the accessibility of your designs by using annotations"
3+
abstract: "Accessibility annotations allow you to specify how the different components present on your wireframe should interact with users and be interpreted by assistance tools"
4+
titleBeforeTag: true
5+
date: "2025-11-04"
6+
updateDate : "2026-02-13"
7+
tags:
8+
- beginner
9+
---
10+
11+
## What is it about?
12+
13+
Accessibility annotations specify how the various components on a screen should be interpreted by assistive tools (like a screen reader) and help to anticipate several accessibility error risks. while some annotations can be added directly by designers during the graphic design phase, others require technical expertise.
14+
This is the main benefit of this activity, which encourages a cross-disciplinary reflection on accessibility (designer, product manager, accessibility expert, developer, etc.).
15+
Without these specifications, technical accessibility rests solely on the shoulders of developers, while it must be, above all, a team effort.
16+
17+
## What should be annotated?
18+
19+
Some information that can be added to your designs:
20+
- Text alternative for images
21+
- Title of each page
22+
- Headings (HTML tags `h1`, `h2`...)
23+
- Semantics (lists, paragraphs, quotations...)
24+
- list of the different page regions (landmarks)
25+
- Interactive components (links, buttons...)
26+
- Reading order of components with screen reader
27+
- Focus moving order
28+
- Forms (labels, mandatory fields, error messages...)
29+
- Keyboard shortcuts (for example Esc to close a dialog box)
30+
- Skip links...
31+
32+
<img src="../images/annotations/example-en.png" alt="Design example with accessibility annotations" title="Design example with accessibility annotations" class="img-fluid">
33+
34+
35+
## How to do it?
36+
37+
Whatever software used, annotating mockups is really easy. For example, you can use numbered bullet points that link to a detailed description. There are also annotation kits or plugins that offer stickers with different colors and shapes that allow you to quickly annotate your designs. The best tool is the one that best suits your way of working. It may vary depending on the profiles and size of your team. Annotation kits, as plugins, provide a foundation that you should feel free to adapt to your needs.
38+
39+
<img src="../images/annotations/reading-order-en.png" alt="Design example with annotations and reading order" title="Design example with annotations and reading order" class="img-fluid">
40+
41+
42+
## Ressources
43+
44+
There are specific tools or plugins for major design/mockup tools like Figma, Sketch, Zeplin.&nbsp;
45+
For any other tools, you can also use annotation kit which specific icons usable in all environments.
46+
47+
Some examples of information that can be added to your designs:
48+
- <a href="https://stephaniewalter.design/blog/a-designers-guide-to-documenting-accessibility-user-interactions/" hreflang="en">A Designer’s Guide to Documenting Accessibility & User Interactions</a>
49+
- <a href="https://tangible.is/en/thinking/2024/10/the-value-of-accessibility-annotations-in-inclusive-design" hreflang="en">The value of accessibility annotations in inclusive design</a>
50+
- <a hreflang="en" href="https://medium.com/indeed-design/building-an-accessibility-library-e134e9012c17">Building an Accessibility Library</a>
51+
- <a hreflang="en" href="https://blog.zeplin.io/introducing-flows-and-annotations-a-new-way-to-communicate-design-intention">Introducing Flows and Annotations</a>
52+
- <a hreflang="en" href="https://www.youtube.com/watch?v=Y35jmpS8lQM&feature=youtu.be&ab_channel=InclusiveDesign24%23id24">Annotating designs for Accessibility / Claire Webber and Sarah Pulis</a>
53+
- <a hreflang="en" href="https://tetralogical.com/blog/2025/09/23/annotating-designs-using-common-language/">Annotating designs using common language / Craig Abbott</a>
54+
55+
Some Figma plugins to add accessibility annotations:
56+
- <a hreflang="en" href="https://www.figma.com/community/file/953682768192596304">Accessibility Annotation Kit by Indeed</a>
57+
- <a hreflang="en" href="https://www.figma.com/community/file/1311421011482282592">Web Accessibility Annotation Kit by CVS Health</a>
58+
- <a hreflang="en" href="https://www.figma.com/comunity/plugin/1085612091163821851">axe for Designers by Deque Systems</a>
59+
- <a hreflang="en" href="https://www.figma.com/community/file/1022394680250523675">Intopia's accessibility annotation kit</a>
60+
- <a hreflang="en" href="https://www.figma.com/community/plugin/731310036968334777/accessibility-assistant">Accessibility Assistant by Microsoft Design</a>
61+
62+
287 KB
Loading
112 KB
Loading
Lines changed: 26 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,61 @@
11
---
2-
title: "Spécifier l'accessibilité de vos design grâce aux annotations"
3-
abstract: "Les annotations d'accessibilité permettent de spécifier comment les différents composants présents sur un écran doivent être interprétés par les outils d'assistance"
2+
title: "Spécifier l'accessibilité de vos designs grâce aux annotations"
3+
abstract: "Les annotations d'accessibilité permettent de spécifier comment les différents composants présents sur un écran doivent interagir avec les utilisateurs et être interprétés par les outils d'assistance"
44
titleBeforeTag: true
55
date: "2022-07-29"
6+
updateDate : "2026-02-13"
67
tags:
78
- beginner
89
---
910

1011
## De quoi s'agit-il ?
1112

12-
Les annotations d'accessibilité permettent de spécifier comment les différents composants présents sur un écran doivent être interprétés par les outils d'assistance (par exemple un lecteur d'écran) et d'anticiper certains risques d'erreur d'accessibilité. Bien que certaines annotations peuvent être ajoutées directement par les designer lors de la phase de conception graphique, d'autres demandent une expertise technique. C'est tout l'intérêt de cette activité qui permet d'engager une réflexion transverse sur l'accessiblité (designer, responsable produit, expert en accessibilité, développeur...).
13+
Les annotations d'accessibilité permettent de spécifier comment les différents composants présents sur un écran doivent être interprétés par les outils d'assistance (par exemple un lecteur d'écran) et d'anticiper certains risques d'erreur d'accessibilité. Bien que certaines annotations peuvent être ajoutées directement par les designers lors de la phase de conception graphique, d'autres demandent une expertise technique. C'est tout l'intérêt de cette activité qui permet d'engager une réflexion transverse sur l'accessibilité (designer, responsable produit, expert en accessibilité, développeur...).
1314
En l'absence de spécification, l'accessibilité technique repose exclusivement sur les épaules des développeurs, or il s'agit avant tout d'un travail d'équipe.
1415

1516
## Que doit-on annoter ?
1617

17-
Voici quelques exemples d'informations qui peuvent être ajoutées sur vos design&nbsp;:
18+
Voici quelques exemples d'informations qui peuvent être ajoutées sur vos designs&nbsp;:
1819
- Les alternatives textuelles pour les images
1920
- Le titre de page
2021
- Les titres à l'intérieur de la page (balises `h1`, `h2`...)
2122
- La sémantique (listes, paragraphes, citations...)
2223
- La liste des différentes régions qui composent la page (landmarks)
24+
- Les éléments interactifs (les liens, les boutons...)
2325
- L'ordre de vocalisation des éléments
2426
- L'ordre de déplacement du focus
25-
- La présence de raccourcis clavier (Esc pour fermer une boite de dialogue par exemple)
27+
- Les formulaires (labels, champs obligatoires, messages d'erreur...)
28+
- La présence de raccourcis clavier (Esc pour fermer une boîte de dialogue par exemple)
2629
- La présence de liens d'évitement...
2730

28-
<img src="../images/annotations/exemple.png" alt="Exemple de design pourvu d'annotations pour l'accessibilité" title="Exemple de design pourvu d'annotations pour l'accessibilité" class="img-fluid">
31+
<img src="../images/annotations/exemple-fr.png" alt="Exemple de design pourvu d'annotations pour l'accessibilité" title="Exemple de design pourvu d'annotations pour l'accessibilité" class="img-fluid">
2932

3033

3134
## Comment fait-on ?
3235

33-
Quel que soit le logiciel utilisé, il est simple d'annoter des maquettes. Par exemple, à l'aide de puces numérotées qui renvoient vers une description détaillée. Il existe également des kits d'annotation qui proposent des pastilles de couleurs et de formes différentes qui permettent d'annoter rapidement un design. Le meilleur outil est celui qui correspond le mieux à votre façon de travailler. Il peut être différent en fonction des profils et de la taille de votre équipe. Les kits d'annotation proposent une base qu'il ne faut donc pas hésiter à faire évoluer selon vos besoins.
36+
Quel que soit le logiciel utilisé, il est simple d'annoter des maquettes. Par exemple, à l'aide de puces numérotées qui renvoient vers une description détaillée. Il existe également des kits d'annotation ou des plugins qui proposent des pastilles de couleurs et de formes différentes qui permettent d'annoter rapidement un design. Le meilleur outil est celui qui correspond le mieux à votre façon de travailler. Il peut être différent en fonction des profils et de la taille de votre équipe. Les kits d'annotation, comme les plugins, proposent une base qu'il ne faut donc pas hésiter à faire évoluer selon vos besoins.
3437

35-
<img src="../images/annotations/ordre de lecture.png" alt="Exemple de design pourvu d'annotations sur l'ordre de lecture des éléments" title="Exemple de design pourvu d'annotations sur l'ordre de lecture des éléments" class="img-fluid">
38+
<img src="../images/annotations/ordre-lecture.png" alt="Exemple de design pourvu d'annotations sur l'ordre de lecture des éléments" title="Exemple de design pourvu d'annotations sur l'ordre de lecture des éléments" class="img-fluid">
3639

3740

3841
## Ressources
3942

40-
Il existe des outils voire des plugins spécifiques pour les principaux outils de maquettage/design&nbsp; : Figma, Scketch, Zeplin.
41-
Mais pour tout autre outil, vous pouvez aussi vous appuyer sur des kits d'annotation qui sont des icones spécifiques utilisables dans tous les environements.
43+
Pour les principaux outils de maquettage/design comme Figma, Sketch, Zeplin, il existe de nombreux outils ou plugins spécifiques.
44+
Pour tout autre outil, vous pouvez aussi vous appuyer sur des kits d'annotation qui sont des icônes spécifiques utilisables dans tous les environnements.
4245

4346
Voici quelques ressources qui vous permettront d'approfondir le sujet&nbsp;:
4447
- <a href="https://stephaniewalter.design/blog/a-designers-guide-to-documenting-accessibility-user-interactions/" lang="en" hreflang="en">A Designer’s Guide to Documenting Accessibility & User Interactions</a>
48+
- <a href="https://tangible.is/en/thinking/2024/10/the-value-of-accessibility-annotations-in-inclusive-design" lang="en" hreflang="en">The value of accessibility annotations in inclusive design</a>
4549
- <a lang="en" hreflang="en" href="https://medium.com/indeed-design/building-an-accessibility-library-e134e9012c17">Building an Accessibility Library</a>
46-
- <a hreflang="en" href="https://www.figma.com/community/file/953682768192596304">Kit d'annotation pour Figma réalisé par Indeed</a>
47-
- <a hreflang="en" href="https://blog.zeplin.io/introducing-flows-and-annotations-a-new-way-to-communicate-design-intention">Faire des annotations dans Zeplin</a>
48-
49-
Présentation vidéo Intopia&nbsp;:
50-
- <a lang="en" hreflang="en" href="https://www.youtube.com/watch?v=Y35jmpS8lQM&feature=youtu.be&ab_channel=InclusiveDesign24%23id24">Annotating designs for Accessibility / Claire Webber and Sarah Pulis</a>
51-
- <a hreflang="en" href="https://www.figma.com/community/file/1022394680250523675">Le kit d'annotation pour Figma réalisé par Intopia</a>
50+
- <a lang="en" hreflang="en" href="https://blog.zeplin.io/introducing-flows-and-annotations-a-new-way-to-communicate-design-intention">Introducing Flows and Annotations</a>
51+
- <a lang="en" hreflang="en" href="https://www.youtube.com/watch?v=Y35jmpS8lQM&feature=youtu.be&ab_channel=InclusiveDesign24%23id24">Annotating designs for Accessibility / Claire Webber and Sarah Pulis</a>
52+
- <a lang="en" hreflang="en" href="https://tetralogical.com/blog/2025/09/23/annotating-designs-using-common-language/">Annotating designs using common language / Craig Abbott</a>
53+
54+
Quelques plugins pour ajouter des annotations sous Figma&nbsp;:
55+
- <a lang="en" hreflang="en" href="https://www.figma.com/community/file/953682768192596304">Accessibility Annotation Kit réalisé par Indeed</a>
56+
- <a lang="en" hreflang="en" href="https://www.figma.com/community/file/1311421011482282592">Web Accessibility Annotation Kit by CVS Health</a>
57+
- <a lang="en" hreflang="en" href="https://www.figma.com/community/plugin/1085612091163821851/axe-for-designers-a-free-accessibility-plugin">axe for Designers by Deque Systems</a>
58+
- <a lang="en" hreflang="en" href="https://www.figma.com/community/file/1022394680250523675">Intopia's accessibility annotation kit</a>
59+
- <a lang="en" hreflang="en" href="https://www.figma.com/community/plugin/731310036968334777/accessibility-assistant">Accessibility Assistant by Microsoft Design</a>
60+
61+
:::::::::
-168 KB
Binary file not shown.
303 KB
Loading
-71.2 KB
Binary file not shown.

src/fr/articles/images/annotations/ordre de lecture.png renamed to src/fr/articles/images/annotations/ordre-lecture.png

File renamed without changes.

0 commit comments

Comments
 (0)