Upgrade details to Open Forms 2.5.0
We do our best to avoid breaking changes, but at times we cannot guarantee that your configuration will keep working flawlessly. Open Forms 2.5.0 is such a release - and the manual interventions with context are documented here.
Form styling - SDK
We continue our adoption of NL Design System, for which the SDK has received some overhauls. Please read and apply the SDK 2.1 upgrade notes.
Form styling - backend
Additionally, we’ve reworked more components in our “backend” which renders the forms, most notably the page header, footer and general scaffolding. This refactor is backwards compatible and covered by an automatic migration, however some tokens cannot be reliably converted.
Note
We have broken some legacy shorthand values into their individual parts. E.g.
a padding value of 10px 20px translates to:
block-start padding: 10px
block-end padding: 10px
inline-start padding: 20px
inline-end padding: 20px
Page header
The old token of.page-header.mobile.padding should be used for:
--of-utrecht-page-header-mobile-padding-block-end--of-utrecht-page-header-mobile-padding-block-start--of-utrecht-page-header-mobile-padding-inline-end--of-utrecht-page-header-mobile-padding-inline-start
The old token of.page-header.tablet.padding should be used for:
--of-utrecht-page-header-tablet-padding-block-end--of-utrecht-page-header-tablet-padding-block-start--of-utrecht-page-header-tablet-padding-inline-end--of-utrecht-page-header-tablet-padding-inline-start
The old token of.page-header.laptop.padding should be used for:
--of-utrecht-page-header-laptop-padding-block-end--of-utrecht-page-header-laptop-padding-block-start--of-utrecht-page-header-laptop-padding-inline-end--of-utrecht-page-header-laptop-padding-inline-start
The old token of.page-header.desktop.padding should be used for:
--of-utrecht-page-header-desktop-padding-block-end--of-utrecht-page-header-desktop-padding-block-start--of-utrecht-page-header-desktop-padding-inline-end--of-utrecht-page-header-desktop-padding-inline-start
Page
You may want to specify a background color for the .utrecht-page selector. Open
Forms currently falls back to --of-layout-background-color, but if you have a custom
theme this will not be picked up.
Other
These are direct mappings and are handled automatically, but if you have custom stylesheets/themes, you should update these:
--of-page-footer-bgbecomes--utrecht-page-footer-background-color--of-page-footer-fgbecomes--utrecht-page-footer-color--of-page-header-bgbecomes--utrecht-page-header-background-color--of-page-header-fgbecomes--utrecht-page-header-color--of-page-header-logo-return-url-min-heightbecomes--of-page-header-logo-return-url-min-block-size--of-page-header-logo-return-url-min-widthbecomes--of-page-header-logo-return-url-min-inline-size--of-page-header-logo-return-url-mobile-min-heightbecomes--of-page-header-logo-return-url-mobile-min-block-size--of-page-header-logo-return-url-mobile-min-widthbecomes--of-page-header-logo-return-url-mobile-min-inline-size