Skip to content

Upgrade to NHS.UK frontend v10.0.0 and support SSR#267

Merged
colinrotherham merged 65 commits intomainfrom
nhsuk-frontend-10.0.0
Sep 30, 2025
Merged

Upgrade to NHS.UK frontend v10.0.0 and support SSR#267
colinrotherham merged 65 commits intomainfrom
nhsuk-frontend-10.0.0

Conversation

@colinrotherham
Copy link
Collaborator

@colinrotherham colinrotherham commented Sep 8, 2025

This PR upgrades to NHS.UK frontend v10.0.0 with server-side rendering (SSR) support

All client-side behaviour is now provided by the NHS.UK frontend JavaScript API

For example:

Visually hidden text for accessibility

For accessibility reasons, it's no longer possible to pass visuallyHiddenText: false for the following:

Conditionally revealing content

Previously, conditionally revealing content (radios, checkboxes) would only be rendered (or fully removed) when their related input was checked. It can be difficult to keep error messages and nested form field values in sync.

Conditionally revealing content is now always rendered but toggled in/out of view using the --hidden modifier.

Accessibility issues with missing aria-controls, aria-describedby or aria-expanded are now fixed.

CommonJS workarounds

Components now use NHS.UK Frontend JavaScript instead of the following workarounds:

import CharacterCountJs from '@resources/character-count';
import CheckboxJs from '@resources/checkboxes';
import HeaderJs from '@resources/header';
import TabsJs from '@resources/tabs';

Made possible since this issue was resolved:

New and unsupported icons

All icons have been redrawn in NHS.UK frontend v10 along with the new "User" icon

The following icons are not supported and have been removed:

  • Chevron down
  • Chevron left
  • Chevron right
  • Close
  • Em dash
  • Em dash (small)
  • Minus
  • Plus

@colinrotherham colinrotherham force-pushed the nhsuk-frontend-10.0.0 branch 2 times, most recently from e771bc2 to dcb9774 Compare September 9, 2025 08:26
@colinrotherham
Copy link
Collaborator Author

I'm going to move this into ready for review whilst I finish off the upgrade-to-6.0.md guide

Copy link
Collaborator

@JoshuaBates-NHS JoshuaBates-NHS left a comment

Choose a reason for hiding this comment

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

Theres quite a few changes in here around certain components (e.g. header), which could do with some updates in storybook + unit tests

UpgradeTov6 is missing in Migration guides also - that will tie together the MD added into the deployed storybook

@frankieroberto
Copy link
Contributor

So much good stuff in here. Thanks @colinrotherham!

@colinrotherham colinrotherham changed the title Upgrade to NHS.UK frontend v10.0.0 Upgrade to NHS.UK frontend v10.0.0 and support SSR Sep 26, 2025
@sonarqubecloud
Copy link

@colinrotherham colinrotherham added this pull request to the merge queue Sep 30, 2025
Merged via the queue into main with commit 144c5a7 Sep 30, 2025
3 checks passed
@colinrotherham colinrotherham deleted the nhsuk-frontend-10.0.0 branch September 30, 2025 16:26
@colinrotherham
Copy link
Collaborator Author

I've confirmed with @ricksmith130 that we're happy to merge this and release 6.0.0-beta.0

it looks like my approval is still valid from before
also I've just been using the updated libraries and all is good

Also discussed with @JoshuaBates-NHS on Slack

If others have reviewed and happy go ahead, I can retrospectively review further changes and we can fix forward

Thanks all

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.

4 participants