Skip to content

Commit fad0e23

Browse files
chore(docs): updated standards to wcag 22 (#4762)
* chore(docs): updated standards to wcag 22 * Added new guidelines from wcag 22 * Added missing cells * Verbiage updates from Erin --------- Co-authored-by: Eric Olkowski <[email protected]>
1 parent 02a0533 commit fad0e23

File tree

9 files changed

+37
-37
lines changed

9 files changed

+37
-37
lines changed

packages/documentation-site/patternfly-docs/content/accessibility/alert/alert.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -145,4 +145,4 @@ You can further customize the way assistive technologies announce the contents o
145145
To read more about accessibility with alerts and alert groups, refer to the following resources:
146146

147147
- [ARIA Authoring Practices Guide - Alerts](https://www.w3.org/WAI/ARIA/apg/patterns/alert/)
148-
- [WCAG 2.0 success criterion 2.2.3 - no timing](https://www.w3.org/TR/UNDERSTANDING-WCAG20/time-limits-no-exceptions.html), if intending to use alerts that automatically get dismissed
148+
- [Understanding Success Criterion 2.2.3: No Timing (Level AAA)](https://www.w3.org/WAI/WCAG22/Understanding/no-timing.html), if intending to use alerts that automatically get dismissed

packages/documentation-site/patternfly-docs/content/accessibility/brand/brand.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,5 +49,5 @@ The following HTML attributes and PatternFly classes can be used for more fine-t
4949

5050
To read more about accessibility with a brand, refer to the following resources:
5151

52-
- [WCAG 1.1: Text Alternatives](https://www.w3.org/TR/WCAG21/#text-alternatives)
52+
- [WCAG 1.1: Text Alternatives](https://www.w3.org/TR/WCAG22/#text-alternatives)
5353
- [Alternative text](https://webaim.org/techniques/alttext/) by WebAIM

packages/documentation-site/patternfly-docs/content/design-guidelines/content/writing-for-all-audiences.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ section: UX writing
66
By following accessibility and global writing best practices, you’ll be better equipped to create product experiences for users of all abilities and backgrounds.
77

88
## Writing for all abilities
9-
When designing interfaces, consider all users’ abilities, including physical and cognitive. Use words that are clear, concise, and consistent. Refer to the [Web Content Accessibility Guidelines (WCAG)](https://www.w3.org/TR/WCAG21/) for accessibility compliance information.
9+
When designing interfaces, consider all users’ abilities, including physical and cognitive. Use words that are clear, concise, and consistent. Refer to the [Web Content Accessibility Guidelines (WCAG) 2.2 Guidelines](https://www.w3.org/TR/WCAG22/) for accessibility compliance information.
1010

1111
To create accessible content, refer to the following best practices:
1212

packages/documentation-site/patternfly-docs/content/design-guidelines/styles/colors/colors.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -186,7 +186,7 @@ Status and state colors are indicators that communicate data and actions to user
186186

187187
## Contrast ratios
188188

189-
[Our goal](/accessibility/patternflys-accessibility/) is for PatternFly to meet [level AA requirements in the Web Content Accessibility Guidelines 2.1](https://www.w3.org/WAI/standards-guidelines/wcag/new-in-21/). To achieve level AA accessibility, your UI contrast ratios must be at or above 4.5:1 for normal text, 3:1 for large text, and 3:1 for graphics and other UI components. Additionally, on hover, link text color should have ample contrast from both the background color and the default state link color.
189+
[Our accessibility standards](/accessibility/patternflys-accessibility#accessibility-standards) are [level AA in the Web Content Accessibility Guidelines 2.2](https://www.w3.org/WAI/WCAG22/quickref/?versions=2.2&currentsidebar=%23col_customize&levels=aaa). To achieve level AA accessibility, your UI contrast ratios must be at or above 4.5:1 for normal text, 3:1 for large text, and 3:1 for graphics and other UI components. Additionally, on hover, link text color should have ample contrast from both the background color and the default state link color.
190190

191191
To check the contrast between background and text colors, use a <a href="https://color.a11y.com/?wc3" target="_blank" className="pf-m-link">WCAG AA-compliance tool.</a>
192192

packages/documentation-site/patternfly-docs/content/developer-resources/about-accessibility.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ To help you achieve this, consider these guidelines:
8787
- Don’t show interactive elements on hover.
8888
- Interactive elements that display in a pop-up must also display on click, touch, or enter-key events.
8989

90-
- Screen reader content should match visibly rendered content (refer to the [first note for `aria-hidden` state](https://www.w3.org/TR/wai-aria/#aria-hidden)).
90+
- Screen reader content should match visibly rendered content (refer to the [first note for `aria-hidden` state](https://www.w3.org/TR/wai-aria/#h-note-59), but keep in mind this references an older version of WCAG guidelines).
9191

9292
- There should be parity between hover and focus events. Any information that’s available on hover for the mouse user should be available on keyboard focus.
9393
- Make content that appears on hover available to a screen reader by using `aria-describedby` (refer to [Tooltips & Toggletips example from Inclusive Components](https://inclusive-components.design/tooltips-toggletips/)).

packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-datalist.js

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,7 @@ export class AccessibilityDatalist extends React.Component {
113113
<div id="ex-item1">Skip to main links</div>
114114
</DataListCell>,
115115
<DataListCell key="secondary content">
116-
<a href="//www.w3.org/WAI/WCAG21/quickref#bypass-blocks">WCAG 2.4.1</a>
116+
<a href="//www.w3.org/WAI/WCAG22/quickref#bypass-blocks">WCAG 2.4.1</a>
117117
</DataListCell>,
118118
<DataListCell key="secondary content 2">
119119
<span>development</span>
@@ -151,7 +151,7 @@ export class AccessibilityDatalist extends React.Component {
151151
<div id="ex-item2">Page titles</div>
152152
</DataListCell>,
153153
<DataListCell key="secondary content 2">
154-
<a href="//www.w3.org/WAI/WCAG21/quickref#page-titled">WCAG 2.4.2</a>
154+
<a href="//www.w3.org/WAI/WCAG22/quickref#page-titled">WCAG 2.4.2</a>
155155
</DataListCell>,
156156
<DataListCell key="secondary content3">
157157
<span>development</span>
@@ -194,7 +194,7 @@ export class AccessibilityDatalist extends React.Component {
194194
<div id="ex-item3">Links</div>
195195
</DataListCell>,
196196
<DataListCell key="secondary content">
197-
<a href="//www.w3.org/WAI/WCAG21/quickref#link-purpose-in-context">WCAG 2.4.4</a>
197+
<a href="//www.w3.org/WAI/WCAG22/quickref#link-purpose-in-context">WCAG 2.4.4</a>
198198
</DataListCell>,
199199
<DataListCell key="secondary content 2">
200200
<span>design, development</span>
@@ -249,7 +249,7 @@ export class AccessibilityDatalist extends React.Component {
249249
<br/>
250250
<br/>
251251
Landmark roles programmatically identify sections of a page. If more than one landmark role occurs in the page, use <code>aria-label</code> to differentiate the landmark elements.
252-
Landmarks help assistive-technology users orient themselves to a page and help them navigate easily to various page sections. Whenever a landmark role is used more than once, provide a name using <code>aria-label</code> or <code>aria-labelledby</code> to provide context for that landmark. (<a href="https://www.w3.org/WAI/WCAG21/Techniques/aria/ARIA6"> ARIA6</a>, <a href="https://w3.org/WAI/WCAG22/Techniques/aria/ARIA16">ARIA16</a>)
252+
Landmarks help assistive-technology users orient themselves to a page and help them navigate easily to various page sections. Whenever a landmark role is used more than once, provide a name using <code>aria-label</code> or <code>aria-labelledby</code> to provide context for that landmark. (<a href="https://www.w3.org/WAI/WCAG22/Techniques/aria/ARIA6"> ARIA6</a>, <a href="https://w3.org/WAI/WCAG22/Techniques/aria/ARIA16">ARIA16</a>)
253253
<br/>
254254
<br/>
255255
<strong>Note:</strong> While toolbar is not a landmark role, the same rule applies.
@@ -272,7 +272,7 @@ export class AccessibilityDatalist extends React.Component {
272272
<div id="ex-item5">Headings</div>
273273
</DataListCell>,
274274
<DataListCell key="secondary content">
275-
<a href="//www.w3.org/WAI/WCAG21/quickref#section-headings">WCAG 2.4.10</a>
275+
<a href="//www.w3.org/WAI/WCAG22/quickref#section-headings">WCAG 2.4.10</a>
276276
</DataListCell>,
277277
<DataListCell key="secondary content 2">
278278
<span>design, development</span>

packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-development.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ These are some of the items outside the scope of PatternFly that you should prio
2424

2525
### UI element accessibility techniques
2626

27-
The [WCAG 2.0 techniques](https://www.w3.org/TR/WCAG20-TECHS/Overview.html#contents) provide examples on how to meet accessibility guidelines. The following techniques are standard across PatternFly for specific patterns.
27+
The [WCAG 2.2 techniques](https://www.w3.org/WAI/WCAG22/Techniques/) provide examples on how to meet accessibility guidelines. The following techniques are standard across PatternFly for specific patterns.
2828

2929
#### Labeling with ARIA
3030

@@ -38,11 +38,11 @@ Note that ARIA can only affect the semantics of an element; it has no effect on
3838

3939
#### Form fields
4040

41-
Use [explicit linking](https://www.w3.org/TR/WCAG20-TECHS/H44.html) between `label` and form input elements (such as `input`, `textarea`, or `select`) when both are present. [This "H44" guidelines](//www.w3.org/TR/WCAG20-TECHS/H44.html) provides an accessible name to screen readers and makes the label clickable to increase the overall clickable area of the form element.
41+
[Use label elements to associate text labels with form controls](https://www.w3.org/WAI/WCAG22/Techniques/html/H44) (such as `input`, `textarea`, or `select`) when both are present. This technique provides an accessible name to screen readers and makes the label clickable to increase the overall clickable area of the form element.
4242

43-
When a `label` element cannot accompany a form input element, provide one using using `aria-label` or `aria-labelledby`, as outline by the ["ARIA14" guidelines](//www.w3.org/TR/WCAG20-TECHS/ARIA14.html).
43+
When a `label` element cannot accompany a form input element, provide one using using `aria-label` or `aria-labelledby`, as outlined by the [WCAG technique ARIA14](https://www.w3.org/WAI/WCAG22/Techniques/aria/ARIA14).
4444

45-
In a single-field form, the submit button label can serve as the field label for sighted users, [following the "G167" guidelines](//www.w3.org/TR/WCAG20-TECHS/general.html#G167). For assistive devices, use `aria-labelledby`.
45+
In a single-field form, the submit button label can serve as the field label for sighted users, following the [WCAG technique G167](https://www.w3.org/WAI/WCAG22/Techniques/general/G167). For assistive devices, use `aria-labelledby`.
4646

4747
#### Icons
4848

packages/documentation-site/patternfly-docs/content/developer-resources/accessibility-testing.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -56,9 +56,9 @@ You can test with any screen reader that is available in your operating system.
5656
### Check color contrast
5757

5858
Your UI's colors should pass the following contrast checks to ensure that users across the vision spectrum can understand your product:
59-
- Text color against background color ([Understanding WCAG 1.4.3](//www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html))
60-
- Text color against link color ([Technique G183](//www.w3.org/TR/WCAG20-TECHS/G183.html))
61-
- Visible boundaries of buttons and form elements against adjacent background color ([Understanding WCAG 1.4.11](//www.w3.org/WAI/WCAG21/Understanding/non-text-contrast.html))
59+
- Text color against background color ([Understanding WCAG 1.4.3](//www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html))
60+
- Text color against link color ([WCAG Technique G183](https://www.w3.org/WAI/WCAG22/Techniques/general/G183))
61+
- Visible boundaries of buttons and form elements against adjacent background color ([Understanding WCAG 1.4.11](//www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html))
6262

6363
## Accessibility testing checklist
6464

0 commit comments

Comments
 (0)