Skip to content

chore(docs): updated standards to wcag 22 - #4762

Merged
nicolethoen merged 4 commits into
patternfly:mainfrom
thatblindgeye:updateWCAGStandard
Sep 5, 2025
Merged

nicolethoen merged 4 commits into
patternfly:mainfrom
thatblindgeye:updateWCAGStandard

Conversation

@thatblindgeye

@thatblindgeye thatblindgeye commented Aug 29, 2025 •

Copy link
Copy Markdown
Contributor

Closes #4763

@patternfly-build

patternfly-build commented Aug 29, 2025 •

Copy link
Copy Markdown
Collaborator

Preview: https://pf-org--pr-4762-site.surge.sh

@edonehoo edonehoo left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Couple small things, but otherwise this looks good to me!

- Interactive elements that display in a pop-up must also display on click, touch, or enter-key events.

- 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)).
- 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) - keep in mind this references an older version of WCAG guidelines).

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- 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) - keep in mind this references an older version of WCAG guidelines).
- 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).

When a `label` element cannot accompany a form input element, provide one using using `aria-label` or `aria-labelledby`, as outline by the [WCAG technique ARIA14](https://www.w3.org/WAI/WCAG22/Techniques/aria/ARIA14).

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`.
In a single-field form, the submit button label can serve as the field label for sighted users, followwing the [WCAG technique G167](https://www.w3.org/WAI/WCAG22/Techniques/general/G167). For assistive devices, use `aria-labelledby`.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
In a single-field form, the submit button label can serve as the field label for sighted users, followwing the [WCAG technique G167](https://www.w3.org/WAI/WCAG22/Techniques/general/G167). For assistive devices, use `aria-labelledby`.
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`.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My w key has been my bane for a while now because of this 😭

[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.

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).
When a `label` element cannot accompany a form input element, provide one using using `aria-label` or `aria-labelledby`, as outline by the [WCAG technique ARIA14](https://www.w3.org/WAI/WCAG22/Techniques/aria/ARIA14).

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When a `label` element cannot accompany a form input element, provide one using using `aria-label` or `aria-labelledby`, as outline by the [WCAG technique ARIA14](https://www.w3.org/WAI/WCAG22/Techniques/aria/ARIA14).
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).

@nicolethoen
nicolethoen merged commit fad0e23 into patternfly:main Sep 5, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update verbiage regarding a11y standards to wcag 2.2

4 participants