Updated the race and ethnicity pattern preview and to match the recommendations in SPD 15.
[!Important]
This update only includes the changes to pattern preview and code. Additional page content updates will come from https://github.com/uswds/uswds-site/issues/2598. These changes have not yet been incorporated, and this PR should not be merged until they are.
[!Important]
We should update the changelog dates before merge.
Figure 1: Race and ethnicity question with minimum categories, multiple detailed checkboxes, and write-in response area with example groups:
Figure 2: Race and ethnicity question with minimum categories only, and examples:
Figure 3: Race and ethnicity question with minimum categories only:
Solution
[!Note]
This PR uses nested fieldsets in the first pattern variant example. The HTML spec shows that it is ok to nest fieldsets, but there is some concern about how nested fieldsets perform in screen readers like JAWS.
Testing and review
[!note]
Review for this will likely come in two phases. In this first phase, I am primarily looking for feedback on the layout and pattern code so that we can be ready to send the component examples on for fed and OMB review. I will continue to revise the template code as the content structure becomes clearer.
General
Confirm the content and design matches the patterns defined in #2598/SPD 15
Confirm all spelling is correct
Identify if there are any interactions or functionality that should be built into the component.
Accessibility
Confirm these form patterns are compatible with assistive technologies and meet accessibility requirements.
Dev
Confirm the form structure matches our recommended code standards.
Outstanding questions
What should the variants be called?
Do we want to add a guidance section for each variant, or do we want a single master guidance section for all variants? (Initial discussion suggested that we will have one master guidance section for all variants)
We will likely need OMB to answer these:
Does the order of the nested checklist items matter? (Should it be alphabetical?)
Should there be any functionality built into these components? For example, if a user selects a sub-category (Ex: "Chinese"), should the "parent" category ("Asian") be automatically selected?
@amycole501 and @alex-hull could you test the three new race and ethnicity pattern examples for accessibility? There are also a couple of possible enhancements that we could use your input on here and here.
amyleadem
commented
4 weeks ago
Summary
Updated the race and ethnicity pattern preview and to match the recommendations in SPD 15.
Related issue
Closes #2651 Related to #2598
Preview link
Race and ethnicity page
Problem statement
Update our race and ethnicity code to match the patterns outlined in USWDS-Site - Enhancement: Update race and ethnicity pattern based on SPD 15
Figure 1: Race and ethnicity question with minimum categories, multiple detailed checkboxes, and write-in response area with example groups:
Figure 2: Race and ethnicity question with minimum categories only, and examples:
Figure 3: Race and ethnicity question with minimum categories only:
Solution
Testing and review
General
Accessibility
Confirm these form patterns are compatible with assistive technologies and meet accessibility requirements.
Dev
Confirm the form structure matches our recommended code standards.
Outstanding questions
We will likely need OMB to answer these: