Skip to content

Conversation

@mdmower-csnw
Copy link
Contributor

@mdmower-csnw mdmower-csnw commented Sep 21, 2025

Work in progress.

This pull request builds off of the work in #3265. When that pull request is merged, this will be rebased and moved out of draft status.

Summary

Apply updates related to features and bug fixes released by USWDS in 3.11.0, 3.12.0, and 3.13.0.

  • Update default error message for file input and apply to aria-label on error
  • Only show in-page navigation if minimum number of headings is found
    • Support setting minimum number of headings via props
  • Include nested headings in in-page navigation
  • Footer story fixes (these changes are not the reason for most Happo differences):
    • Remove incorrectly applied usa-footer__secondary-link class to footer story anchors (the class is applied by the FooterNav component to <li>)
    • Update primary link text in slim and medium FooterNav stories to match the text used in the Footer stories
    • Render only <FooterNav> for the big FooterNav variant, not with <Footer> wrapping it

Notable omissions:

  • 3.12: The existing i18n support in date picker is a better option than generating locale specific calendar labels based on the HTML lang attribute since only some labels could be generated.
  • 3.12: The tooltip component already supports non-button elements.
  • 3.13: USWDS Elements is still in the earliest stages of support (only usa-banner for now). Dedicated attention to web components support would be best handled by a separate pull request.

Related Issues or PRs

(none)

How To Test

Confirm things work the same as described in USWDS release notes: 3.11.0, 3.12.0, and 3.13.0.

Happo differences

Otherwise, headers need to be in a certain DOM context to avoid a11y issues, and this is how USWDS does it
also matches uswds implementation, fixed tests
@mdmower-csnw mdmower-csnw changed the title feat: upgrade to USWDS 3.11.0 feat: upgrade to USWDS 3.12.0 Sep 21, 2025
@mdmower-csnw mdmower-csnw changed the title feat: upgrade to USWDS 3.12.0 feat: upgrade to USWDS 3.13.0 Sep 24, 2025
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.

2 participants