From 08f59e0582c18f82998c561ac22fea8aa8eb9ea3 Mon Sep 17 00:00:00 2001 From: Vincent Smedinga Date: Thu, 21 Nov 2024 15:21:21 +0100 Subject: [PATCH 1/2] Add two references on writing alt texts for images --- packages/css/src/components/image/README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/packages/css/src/components/image/README.md b/packages/css/src/components/image/README.md index 2c120ac8cc..2887af83b6 100644 --- a/packages/css/src/components/image/README.md +++ b/packages/css/src/components/image/README.md @@ -32,3 +32,16 @@ If the intrinsic dimensions of the source do not match an aspect ratio, the imag - [WCAG 1.1.1](https://www.w3.org/TR/WCAG22/#non-text-content): Non-text content must have a text alternative. - [WCAG 1.4.5](https://www.w3.org/TR/WCAG22/#images-of-text): Use text instead of images of text. - [WCAG 1.4.9](https://www.w3.org/TR/WCAG22/#images-of-text-no-exception): Use images of text only when there is no alternative. + +## Further reading + +- [Alt Text: Not Always Needed](https://www.nngroup.com/articles/alt-text-usability/) + (Nielsen Norman Group) + “Just like anyone else, what people want most is an easy path to accomplish basic tasks. + Adding alt text to every image does not automatically make webpage content easy to navigate and consume. + Screen-reader users navigate digital devices differently — they do not rely on visual information, + which means they are not interested in designers’ attempts to recreate visual experiences for them.” +- [How to Write Good Alt Text](https://www.w3.org/WAI/tutorials/images/decision-tree/) + (Web Accessibility Initiative) + Four questions help you decide whether an image needs describing and how to do so. + “This decision tree describes how to use the alt attribute of the image element in various situations.” From 1934a1f312e3d88c68c7d5bdadf3fd4eedb5940c Mon Sep 17 00:00:00 2001 From: Vincent Smedinga Date: Tue, 26 Nov 2024 20:08:19 +0100 Subject: [PATCH 2/2] Make citation less verbose Co-authored-by: Aram <37216945+alimpens@users.noreply.github.com> --- packages/css/src/components/image/README.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/packages/css/src/components/image/README.md b/packages/css/src/components/image/README.md index 2887af83b6..b8216c70fd 100644 --- a/packages/css/src/components/image/README.md +++ b/packages/css/src/components/image/README.md @@ -37,9 +37,8 @@ If the intrinsic dimensions of the source do not match an aspect ratio, the imag - [Alt Text: Not Always Needed](https://www.nngroup.com/articles/alt-text-usability/) (Nielsen Norman Group) - “Just like anyone else, what people want most is an easy path to accomplish basic tasks. - Adding alt text to every image does not automatically make webpage content easy to navigate and consume. - Screen-reader users navigate digital devices differently — they do not rely on visual information, + “Adding alt text to every image does not automatically make webpage content easy to navigate and consume. + Screen-reader users [...] do not rely on visual information, which means they are not interested in designers’ attempts to recreate visual experiences for them.” - [How to Write Good Alt Text](https://www.w3.org/WAI/tutorials/images/decision-tree/) (Web Accessibility Initiative)