Skip to content

Conversation

@rianrietveld
Copy link
Member

@rianrietveld rianrietveld commented Nov 12, 2025

The related issue number: #157
Preview: https://wpaccessibility.org/pr-preview/pr-217/docs/topics/forms/fieldsets/

Adds content about fieldsets, legends and description s with a fieldset in forms.

I moved info about the descriptions from the section about input/label to this section as that made more sense. I added a reference and a link on the input/label - description page to the new location.

This needs a demo with a video, I will do that when I figured out how to make screen videos with NVDA on Windows.

@github-actions
Copy link
Contributor

github-actions bot commented Nov 12, 2025

PR Preview
Preview removed because the pull request was closed.
2025-11-21 12:18 UTC

@rianrietveld rianrietveld linked an issue Nov 12, 2025 that may be closed by this pull request
@rianrietveld rianrietveld moved this to PRs to review in WP A11y docs Nov 12, 2025
Copy link
Member

@joedolson joedolson left a comment

Choose a reason for hiding this comment

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

I have some quarrel with stating that fieldset/legend are required for WCAG; I'd argue that they're the preferred technique, but not the sole way to meet this criteria.

@rianrietveld rianrietveld self-assigned this Nov 13, 2025
@rianrietveld
Copy link
Member Author

rianrietveld commented Nov 14, 2025

I have some quarrel with stating that fieldset/legend are required for WCAG; I'd argue that they're the preferred technique, but not the sole way to meet this criteria.

I changed the text into "WCAG Success Criteria for naming grouped form fields" and added an ARIA example with the comment (not preferred).

I made all the changes, thank you for the review.

# Conflicts:
#	docs/topics/forms/descriptions/content-description.md
#	docs/topics/forms/descriptions/decision-tree-description.md
#	docs/topics/forms/fieldsets.md
GaryJones
GaryJones previously approved these changes Nov 16, 2025
Copy link
Collaborator

@GaryJones GaryJones left a comment

Choose a reason for hiding this comment

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

Few little tweaks needed I think, but ✅

@rianrietveld
Copy link
Member Author

Thanks @GaryJones for the review, I made the changes you suggested. Can you please approve and merge if you agree?

@GaryJones
Copy link
Collaborator

@rianrietveld One more set of value attributes needed in docs/topics/forms/fieldsets/index.md.

@rianrietveld
Copy link
Member Author

Thanks @GaryJones I hope I've got everything now :-)

@GaryJones GaryJones merged commit 0156893 into main Nov 21, 2025
1 check passed
@github-project-automation github-project-automation bot moved this from PRs to review to Done in WP A11y docs Nov 21, 2025
@GaryJones GaryJones deleted the 157-group-form-fields branch November 21, 2025 12:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

[Topic] Fieldset and legend to group form fields

4 participants