Skip to content

Conversation

@mdmower-csnw
Copy link
Contributor

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

This is a continuation of #2848 by @werdnanoslen since it doesn't look like additional movement is expected there.

Summary

These are the features released by USWDS in 3.8.0, 3.8.1, and 3.8.2:

  • Added styles for indeterminate checkboxes and radios
  • Added the ability to customize which headings will be pulled into the in-page navigation link list
    • Also changed class name and selection criteria for bolded heading
  • Added a sticky header variant to the table component
  • Updated sidenav example in documentation per new theme setting
  • Made tooltip content hoverable
  • Made tooltip dismissible with escape key
  • Added textarea validation storybook entry
  • Changed button centering from text-center to flex-justify-center since display for buttons changed from inline-block to inline-flex in USWDS - Button: Add basic support for usa-icon in buttons uswds/uswds#5398.
  • Removed tooltip opacity override that was fixed by USWDS: USWDS - Tooltip: Add opacity:0 to initial state uswds/uswds#5475
  • Changed button-based pagination to use <button> instead of <Button unstyled> to avoid style conflicts between usa-button--unstyled and usa-pagination__button classes (notably, hover styles). Apply minimal utility classes to align styles with link-based pagination.

No action needed to support $theme-table-background-color. It has been verified working by temporarily setting $theme-table-background-color: 'primary-vivid' in src/styles/_uswds-theme.scss and then rebuilding USWDS (yarn build:uswds) followed by running the storybook (yarn storybook).

Related Issues or PRs

Supersedes #2848 and #2962.

How To Test

Confirm things work the same as described in USWDS release notes: 3.8.0, 3.8.1, and 3.8.2.

Happo differences

  • Components/Search/SearchButton/Small search: Alignment of the icon in mobile layout is fixed by USWDS styles.
  • Components/Search/SearchButton/* and Components/Search/Search/*: All of these very slight button height differences are the result of display changing from inline-block to inline-flex in USWDS - Button: Add basic support for usa-icon in buttons uswds/uswds#5398. Opting to allow changes.

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 An mdm 3.8.1 feat: upgrade to USWDS 3.8.1 Sep 20, 2025
- Fix my incorrect merge in radio stories that removed the Default
  component
- Undo label changes to checkboxes
@mdmower-csnw mdmower-csnw changed the title feat: upgrade to USWDS 3.8.1 feat: upgrade to USWDS 3.8.2 Sep 20, 2025
In stories, restore centering of "Go back" (and related) plain text
buttons in modals by changing display to `inline-block`, as it was prior
to USWDS 3.8.0.
USWDS unstyled buttons result in appearance differences from link-based
pagination. This is especially true for hover styles. Use regular
`<button>` with minimal utility styles to more closely resemble
link-based pagination.
@mdmower-csnw mdmower-csnw marked this pull request as ready for review September 20, 2025 21:29
@mdmower-csnw mdmower-csnw requested review from a team as code owners September 20, 2025 21:29
@mdmower-csnw
Copy link
Contributor Author

mdmower-csnw commented Sep 20, 2025

@jpandersen87 @brandonlenz (and cc: @werdnanoslen just in case you are still active in the project) - Would you be willing to review this changeset? I think it'd be best to increment USWDS one or two minor versions at a time, rather than trying to jump to the latest revision. Plus, @werdnanoslen had this 3.8 update largely done and it would be nice to respect his contribution.

EDIT: FYI, I've started work on 3.9 (#3264), 3.10 (#3265), and 3.11+3.12+3.13 (#3266).

@mdmower-csnw
Copy link
Contributor Author

@crwallace - I just noticed you are listed as the active maintainer for this project in the readme. Are you able to help with reviews? Thanks!

I've also started work on 3.9 (#3264), 3.10 (#3265), and 3.11+3.12+3.13 (#3266).

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