From 945ebcb35a65aba31f2a69577404f143e34a0673 Mon Sep 17 00:00:00 2001 From: Erin Donehoo Date: Thu, 12 Oct 2023 14:35:56 -0400 Subject: [PATCH 01/15] docs(accessibility-design): Adds new documentation to support content audit. --- .../accessibility-design.md | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md new file mode 100644 index 0000000000..a371a48071 --- /dev/null +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -0,0 +1,52 @@ +--- +id: Accessible design +section: accessibility +--- + +As described in our [accessibility fundamentals](/accessibility/accessibility-fundamentals), users may interact with your product through a variety of assistive technologies. In addition to [developing accessibly](/accessibility/accessibility-development), you must design accessibly. + +| Designer | Designer and developer | Developer | +| --- | --- | --- | +| Color | Layout and structure | Semantic HTML | +| Contrast | Information architecture and navigation | tab order | +| Content | Interaction patterns | Bypass blocks | + +## Color and contrast + +Color and contrast go hand-in-hand for visual design. + +For example, you should consider contrast when using colors commonly affected by color perception deficiency ([such as those described by W3C](https://www.w3.org/WAI/GL/low-vision-a11y-tf/wiki/Overview_of_Low_Vision#Color_Perception)). Different colors in a UI should be distinguishable for users across the color perception deficiency spectrum, typically by ensuring that each color has a different contrast weight. + +Designing with contrast in mind also benefits users with light sensitivity. + +[PatternFly's colors](/design-foundations/colors) pass color contrast tests, so long as you follow our recommendations. + +## Content + +Your text content should also consider the needs of users with low vision. For example, links should be descriptive and concise, so that users can quickly identify their purpose. + +To help simplify and strengthen the way that users process content, it is also important to carefully consider your text size, font, letter spacing, margins, and spacing. PatternFly supports these considerations through its [typography](/design-foundations/typography) and [spacing](/design-foundations/spacers) guidelines. + +## Understanding low vision + +In addition to following the previous recommendations, it can be helpful to develop an understanding of low-vision users, so that their needs are top of mind as you design. + +**Low vision** is frequently defined as a visual impairment that impedes a person’s ability to perform everyday tasks, which cannot be corrected with glasses, contacts, medicine, or surgery. + +There are 4 types of limitations as a result of low vision. + +### 1. Visual acuity + +**Visual acuity** refers to sharpness of vision (20/20 being standard). Users outside of the standard range of visual acuity have different needs for font size and spacing. + +### 2. Field of vision + +**Field of vision** is the area of vision people can see clearly when their eyes are in a fixed position. Some users have a restricted field of vision (such as central or peripheral field loss), which means that they rely on accessible content design in order to comprehend information on a page. + +### 3. Contrast and light sensitivity + +**Contrast and light sensitivity** refers to the way that people perceive luminance (the contrast of foreground and background). Following our color contrast guidelines can help you support users with deficiencies in these areas. + +### 4. Color perception + +**Color perception** affects how people see colors. Some of your users may have deficiencies in color perception (more than 300 million people are part of this group), which affects their ability to see certain colors. This condition is commonly called "color blindness", even though most people with color perception deficiencies can still see most colors. Following our color contrast guidelines can help you support users with deficiencies in these areas. \ No newline at end of file From c9f5ccf72a7d4356d8bd0ab8daf94607f3aa63e2 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Thu, 12 Oct 2023 15:21:02 -0400 Subject: [PATCH 02/15] Test page name change --- .../content/developer-resources/accessibility-design.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index a371a48071..122a1ba5d4 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -1,5 +1,5 @@ --- -id: Accessible design +id: Design accessibly section: accessibility --- From d82b049ea762e86ce0c712b0f77f4bd2b9e46092 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Fri, 20 Oct 2023 15:44:14 -0400 Subject: [PATCH 03/15] Apply suggestions from code review --- .../content/developer-resources/accessibility-design.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index 122a1ba5d4..8c12a05062 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -1,5 +1,5 @@ --- -id: Design accessibly +id: Design for accessibility section: accessibility --- From 6f78c44050d3405536a9a86b72b62c6d1fae4010 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Mon, 23 Oct 2023 14:55:18 -0400 Subject: [PATCH 04/15] Update packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md --- .../content/developer-resources/accessibility-design.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index 8c12a05062..a78753c356 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -13,7 +13,7 @@ As described in our [accessibility fundamentals](/accessibility/accessibility-fu ## Color and contrast -Color and contrast go hand-in-hand for visual design. +Color and contrast go hand-in-hand for visual design accessibility. For example, you should consider contrast when using colors commonly affected by color perception deficiency ([such as those described by W3C](https://www.w3.org/WAI/GL/low-vision-a11y-tf/wiki/Overview_of_Low_Vision#Color_Perception)). Different colors in a UI should be distinguishable for users across the color perception deficiency spectrum, typically by ensuring that each color has a different contrast weight. From bf893ee70969283ef6d15fbcc0b8ce6cd7f2ef48 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Mon, 23 Oct 2023 14:55:22 -0400 Subject: [PATCH 05/15] Update packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md --- .../content/developer-resources/accessibility-design.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index a78753c356..549b6b6544 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -3,7 +3,7 @@ id: Design for accessibility section: accessibility --- -As described in our [accessibility fundamentals](/accessibility/accessibility-fundamentals), users may interact with your product through a variety of assistive technologies. In addition to [developing accessibly](/accessibility/accessibility-development), you must design accessibly. +As described in our [accessibility fundamentals](/accessibility/accessibility-fundamentals), users may interact with your product through a variety of assistive technologies. In addition to [developing for accessibility](/accessibility/accessibility-development), you must also incorporate it into your product's UI design. | Designer | Designer and developer | Developer | | --- | --- | --- | From 947caf07aea02ce5ae4a28df7817ea3bcec00051 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Mon, 23 Oct 2023 14:55:26 -0400 Subject: [PATCH 06/15] Update packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md --- .../content/developer-resources/accessibility-design.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index 549b6b6544..ebfe42b17f 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -4,7 +4,7 @@ section: accessibility --- As described in our [accessibility fundamentals](/accessibility/accessibility-fundamentals), users may interact with your product through a variety of assistive technologies. In addition to [developing for accessibility](/accessibility/accessibility-development), you must also incorporate it into your product's UI design. - +The following table differentiates the accessibility responsibilities that are up to designers, developers, or both to uphold. | Designer | Designer and developer | Developer | | --- | --- | --- | | Color | Layout and structure | Semantic HTML | From 344769de1033aeff15b2ff89bd4e71d5b35f51c7 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Mon, 23 Oct 2023 14:55:30 -0400 Subject: [PATCH 07/15] Update packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md --- .../content/developer-resources/accessibility-design.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index ebfe42b17f..02a3278319 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -8,7 +8,7 @@ The following table differentiates the accessibility responsibilities that are u | Designer | Designer and developer | Developer | | --- | --- | --- | | Color | Layout and structure | Semantic HTML | -| Contrast | Information architecture and navigation | tab order | +| Contrast | Information architecture and navigation | Tab order | | Content | Interaction patterns | Bypass blocks | ## Color and contrast From c895d6777f939ee20e7d217d1551962c16f02986 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Mon, 23 Oct 2023 14:55:35 -0400 Subject: [PATCH 08/15] Update packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md --- .../content/developer-resources/accessibility-design.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index 02a3278319..9a7e4f4ae9 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -25,7 +25,7 @@ Designing with contrast in mind also benefits users with light sensitivity. Your text content should also consider the needs of users with low vision. For example, links should be descriptive and concise, so that users can quickly identify their purpose. -To help simplify and strengthen the way that users process content, it is also important to carefully consider your text size, font, letter spacing, margins, and spacing. PatternFly supports these considerations through its [typography](/design-foundations/typography) and [spacing](/design-foundations/spacers) guidelines. +To help simplify and strengthen the way that users process content, it is also important to carefully consider your text size, font, letter spacing, margins, and spacing. PatternFly supports these considerations through our [typography](/design-foundations/typography) and [spacing](/design-foundations/spacers) guidelines. ## Understanding low vision From d355ee7adb619cdd5d6124e0aac23420d0e95459 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Tue, 24 Oct 2023 17:52:14 -0400 Subject: [PATCH 09/15] Update packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md --- .../content/developer-resources/accessibility-design.md | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index 9a7e4f4ae9..ca350aaaab 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -4,6 +4,7 @@ section: accessibility --- As described in our [accessibility fundamentals](/accessibility/accessibility-fundamentals), users may interact with your product through a variety of assistive technologies. In addition to [developing for accessibility](/accessibility/accessibility-development), you must also incorporate it into your product's UI design. + The following table differentiates the accessibility responsibilities that are up to designers, developers, or both to uphold. | Designer | Designer and developer | Developer | | --- | --- | --- | From d124621c1f4bd91ca0e705c118888f24a1342425 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Tue, 24 Oct 2023 17:52:19 -0400 Subject: [PATCH 10/15] Update packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md --- .../content/developer-resources/accessibility-design.md | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index ca350aaaab..366597303f 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -6,6 +6,7 @@ section: accessibility As described in our [accessibility fundamentals](/accessibility/accessibility-fundamentals), users may interact with your product through a variety of assistive technologies. In addition to [developing for accessibility](/accessibility/accessibility-development), you must also incorporate it into your product's UI design. The following table differentiates the accessibility responsibilities that are up to designers, developers, or both to uphold. + | Designer | Designer and developer | Developer | | --- | --- | --- | | Color | Layout and structure | Semantic HTML | From 297a1ccacb5a57253aad06c7e4c9928c6877e502 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Tue, 31 Oct 2023 09:43:55 -0400 Subject: [PATCH 11/15] Update packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md --- .../content/developer-resources/accessibility-design.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index 366597303f..bff6325983 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -17,7 +17,7 @@ The following table differentiates the accessibility responsibilities that are u Color and contrast go hand-in-hand for visual design accessibility. -For example, you should consider contrast when using colors commonly affected by color perception deficiency ([such as those described by W3C](https://www.w3.org/WAI/GL/low-vision-a11y-tf/wiki/Overview_of_Low_Vision#Color_Perception)). Different colors in a UI should be distinguishable for users across the color perception deficiency spectrum, typically by ensuring that each color has a different contrast weight. +For example, you should consider contrast when using colors commonly affected by color perception deficiency (such as those described in [color perception by W3C](https://www.w3.org/WAI/GL/low-vision-a11y-tf/wiki/Overview_of_Low_Vision#Color_Perception)). Different colors in a UI should be distinguishable for users across the color perception deficiency spectrum, typically by ensuring that each color has a different contrast weight. Designing with contrast in mind also benefits users with light sensitivity. From 86585dbaf5604cc990063fbd8588b69d51c8d429 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Tue, 31 Oct 2023 09:51:05 -0400 Subject: [PATCH 12/15] Remove table --- .../content/developer-resources/accessibility-design.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index bff6325983..a07174fbbd 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -5,13 +5,7 @@ section: accessibility As described in our [accessibility fundamentals](/accessibility/accessibility-fundamentals), users may interact with your product through a variety of assistive technologies. In addition to [developing for accessibility](/accessibility/accessibility-development), you must also incorporate it into your product's UI design. -The following table differentiates the accessibility responsibilities that are up to designers, developers, or both to uphold. -| Designer | Designer and developer | Developer | -| --- | --- | --- | -| Color | Layout and structure | Semantic HTML | -| Contrast | Information architecture and navigation | Tab order | -| Content | Interaction patterns | Bypass blocks | ## Color and contrast From d60aede972917e8de03cf92ab78f604e4bf9c489 Mon Sep 17 00:00:00 2001 From: Erin Donehoo Date: Tue, 7 Nov 2023 10:21:19 -0500 Subject: [PATCH 13/15] Removes numbers from headings. --- .../developer-resources/accessibility-design.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index a07174fbbd..5ea1d93332 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -5,8 +5,6 @@ section: accessibility As described in our [accessibility fundamentals](/accessibility/accessibility-fundamentals), users may interact with your product through a variety of assistive technologies. In addition to [developing for accessibility](/accessibility/accessibility-development), you must also incorporate it into your product's UI design. - - ## Color and contrast Color and contrast go hand-in-hand for visual design accessibility. @@ -31,18 +29,18 @@ In addition to following the previous recommendations, it can be helpful to deve There are 4 types of limitations as a result of low vision. -### 1. Visual acuity +### Visual acuity **Visual acuity** refers to sharpness of vision (20/20 being standard). Users outside of the standard range of visual acuity have different needs for font size and spacing. -### 2. Field of vision +### Field of vision **Field of vision** is the area of vision people can see clearly when their eyes are in a fixed position. Some users have a restricted field of vision (such as central or peripheral field loss), which means that they rely on accessible content design in order to comprehend information on a page. -### 3. Contrast and light sensitivity +### Contrast and light sensitivity **Contrast and light sensitivity** refers to the way that people perceive luminance (the contrast of foreground and background). Following our color contrast guidelines can help you support users with deficiencies in these areas. -### 4. Color perception +### Color perception **Color perception** affects how people see colors. Some of your users may have deficiencies in color perception (more than 300 million people are part of this group), which affects their ability to see certain colors. This condition is commonly called "color blindness", even though most people with color perception deficiencies can still see most colors. Following our color contrast guidelines can help you support users with deficiencies in these areas. \ No newline at end of file From 840888c54b132de29876f232f54c4e4b5d1033da Mon Sep 17 00:00:00 2001 From: Erin Donehoo Date: Mon, 4 Dec 2023 10:51:26 -0500 Subject: [PATCH 14/15] Makes content updates and adds images. --- .../accessibility-design.md | 45 ++++++++++-------- .../ally-color-example.png | Bin 0 -> 67846 bytes .../ally-contrast-example.png | Bin 0 -> 42506 bytes 3 files changed, 25 insertions(+), 20 deletions(-) create mode 100644 packages/documentation-site/patternfly-docs/content/developer-resources/ally-color-example.png create mode 100644 packages/documentation-site/patternfly-docs/content/developer-resources/ally-contrast-example.png diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index 5ea1d93332..c3bdc2c5b8 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -3,44 +3,49 @@ id: Design for accessibility section: accessibility --- -As described in our [accessibility fundamentals](/accessibility/accessibility-fundamentals), users may interact with your product through a variety of assistive technologies. In addition to [developing for accessibility](/accessibility/accessibility-development), you must also incorporate it into your product's UI design. +import { Card, CardBody, Grid, GridItem } from '@patternfly/react-core'; + +As described in our [accessibility fundamentals](/accessibility/accessibility-fundamentals), users may interact with your product through a variety of assistive technologies. In addition to [developing for accessibility](/accessibility/accessibility-development), you must also incorporate it into your product's visual design. ## Color and contrast Color and contrast go hand-in-hand for visual design accessibility. -For example, you should consider contrast when using colors commonly affected by color perception deficiency (such as those described in [color perception by W3C](https://www.w3.org/WAI/GL/low-vision-a11y-tf/wiki/Overview_of_Low_Vision#Color_Perception)). Different colors in a UI should be distinguishable for users across the color perception deficiency spectrum, typically by ensuring that each color has a different contrast weight. +For example, you should consider contrast when using colors commonly affected by color perception deficiency (such as those described in ["Overview of Low Vision" by W3C](https://www.w3.org/WAI/GL/low-vision-a11y-tf/wiki/Overview_of_Low_Vision#Color_Perception)). Different colors in a UI should be distinguishable for users across the color perception deficiency spectrum, typically by ensuring that each color has a different contrast weight. Designing with contrast in mind also benefits users with light sensitivity. -[PatternFly's colors](/design-foundations/colors) pass color contrast tests, so long as you follow our recommendations. - -## Content +PatternFly components use [our color palettes](/design-foundations/colors) to pass color contrast tests. As long as you follow our recommendations, any UI built with PatternFly components should have proper contrast between colors, making them distinguishable for users with different types of color perception and light sensitivity. -Your text content should also consider the needs of users with low vision. For example, links should be descriptive and concise, so that users can quickly identify their purpose. +It's important not to solely rely on color for conveying information. Even though PatternFly components pass color contrast tests, they also use icons to further help with identification. -To help simplify and strengthen the way that users process content, it is also important to carefully consider your text size, font, letter spacing, margins, and spacing. PatternFly supports these considerations through our [typography](/design-foundations/typography) and [spacing](/design-foundations/spacers) guidelines. - -## Understanding low vision +
+Image comparing alert component appearance for normal color vision to red-green color blindess. +
+
-In addition to following the previous recommendations, it can be helpful to develop an understanding of low-vision users, so that their needs are top of mind as you design. +If you go beyond our recommendations to combine PatternFly colors in other ways, please be sure to check your color contrast with a contrast checker. When you alter the colors and/or icons used in PatternFly components, know that they may no longer be accessible for all users. -**Low vision** is frequently defined as a visual impairment that impedes a person’s ability to perform everyday tasks, which cannot be corrected with glasses, contacts, medicine, or surgery. +
+Image of alert component appearance for users with red-green color blindness, when color and contrast are not accessible and icons are not related to labels. -There are 4 types of limitations as a result of low vision. +## Content -### Visual acuity +The text in your UI should also be accessible to users with low vision. For example, links should be descriptive and concise, essential content should not be hidden in the UI, and text should scale appropriately as the UI window is resized or magnified. -**Visual acuity** refers to sharpness of vision (20/20 being standard). Users outside of the standard range of visual acuity have different needs for font size and spacing. +To help simplify and strengthen the way that users process content, it is important to carefully consider your text size, font, letter spacing, margins, and spacing. PatternFly supports accessibility in these areas through our [typography](/design-foundations/typography) and [spacing](/design-foundations/spacers) guidelines. -### Field of vision +## Understanding low vision -**Field of vision** is the area of vision people can see clearly when their eyes are in a fixed position. Some users have a restricted field of vision (such as central or peripheral field loss), which means that they rely on accessible content design in order to comprehend information on a page. +In addition to following the previous recommendations, it is helpful to develop an understanding of low-vision users, so that their needs are a key concern as you design. -### Contrast and light sensitivity +**Low vision** refers to any visual impairment that impedes a person’s ability to perform everyday tasks, which cannot be corrected with glasses, contacts, medicine, or surgery. -**Contrast and light sensitivity** refers to the way that people perceive luminance (the contrast of foreground and background). Following our color contrast guidelines can help you support users with deficiencies in these areas. +There are 4 types of limitations as a result of low vision. -### Color perception +1. **Visual acuity**: A measure of a person's visual sharpness, with 20/20 being the standard. +1. **Field of vision**: The area of vision that people can see clearly when their eyes are in a fixed position. Some users have a restricted field of vision, such as central or peripheral field loss. +1. **Color perception**: How people see colors. Some of your users may have deficiencies in color perception that affects their ability to see certain colors. This is commonly called "color blindness", but many people with color perception deficiencies can still see most colors. +1. **Contrast and light sensitivity**: The way that people perceive luminance (the contrast of foreground and background). -**Color perception** affects how people see colors. Some of your users may have deficiencies in color perception (more than 300 million people are part of this group), which affects their ability to see certain colors. This condition is commonly called "color blindness", even though most people with color perception deficiencies can still see most colors. Following our color contrast guidelines can help you support users with deficiencies in these areas. \ No newline at end of file +We do our best to make PatternFly accessible for low-vision users by default, but it is important that you consciously design with these needs in mind to ensure that your final design has proper color, contrast, and content accessibility. \ No newline at end of file diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/ally-color-example.png b/packages/documentation-site/patternfly-docs/content/developer-resources/ally-color-example.png new file mode 100644 index 0000000000000000000000000000000000000000..dd67afcc7a39fe8d7937dbc096c025d164372f56 GIT binary patch literal 67846 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 G@_zt4wt{E? literal 0 HcmV?d00001 diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/ally-contrast-example.png b/packages/documentation-site/patternfly-docs/content/developer-resources/ally-contrast-example.png new file mode 100644 index 0000000000000000000000000000000000000000..40b47670a3b5bf7a831960cfd5ca06d559084c47 GIT binary patch literal 42506 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 eg Date: Mon, 11 Dec 2023 10:48:43 -0500 Subject: [PATCH 15/15] Updates to content describing images. --- .../content/developer-resources/accessibility-design.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md index c3bdc2c5b8..5a571853a9 100644 --- a/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md +++ b/packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-design.md @@ -17,17 +17,17 @@ Designing with contrast in mind also benefits users with light sensitivity. PatternFly components use [our color palettes](/design-foundations/colors) to pass color contrast tests. As long as you follow our recommendations, any UI built with PatternFly components should have proper contrast between colors, making them distinguishable for users with different types of color perception and light sensitivity. -It's important not to solely rely on color for conveying information. Even though PatternFly components pass color contrast tests, they also use icons to further help with identification. +It's important not to solely rely on color for conveying information. Even though PatternFly components pass color contrast tests, they also use icons to further help with identification, which can be especially helpful for users with a form of color blindness.
-Image comparing alert component appearance for normal color vision to red-green color blindess. +Two sets of alert components being compared, one displayed as normal and the other displayed with red-green color blindness emulated.

If you go beyond our recommendations to combine PatternFly colors in other ways, please be sure to check your color contrast with a contrast checker. When you alter the colors and/or icons used in PatternFly components, know that they may no longer be accessible for all users.
-Image of alert component appearance for users with red-green color blindness, when color and contrast are not accessible and icons are not related to labels. +A set of alert components displayed with red-green color blindness emulated. These alert components are not clear or distinguishable, because they use poor color contrast and irrelevant icons. ## Content