Skip to content

v2.0.0
Compare
Choose a tag to compare
@gunndabad gunndabad released this 03 May 15:09
· 12 commits to main since this release
v2.0.0
cbba9c0

Targets GOV.UK Frontend v5.1.0.

New features

GOV.UK Frontend hosting options

Previously the GOV.UK Frontend library's assets were always hosted at the root of the application.
Many applications generate their own CSS and/or JavaScript bundles and don't need the standard versions at all, though they likely still need the static assets (fonts, images etc.).
There are now two properties on GovUkFrontendOptions to control the hosting of the static assets and the compiled assets - StaticAssetsContentPath (default /assets) and CompiledContentPath (default /govuk), respectively.
Applications that build and reference their own CSS and JavaScript can set CompiledContentPath to null to skip hosting the standard compiled assets. Similarly, setting StaticAssetsContentPath to null will skip hosting the static assets.

Page template

PageTemplateHelper and the _GovUkPageTemplate.cshtml view have been updated to respect the StaticAssetsContentPath and CompiledContentPath paths set on GovUkFrontendOptions.

An additional ViewData key can now be passed to _GovUkPageTemplate.cshtml - AssetPath. When specified, it will be used in place of the StaticAssetsContentPath value from GovUkFrontendOptions for referencing static asserts.

GovUkFrontendJsEnabledScript, GovUkFrontendScriptImports and GovUkFrontendStyleImports extension methods have been added over IHtmlHelper that wrap the
GenerateJsEnabledScript, GovUkFrontendScriptImports and GovUkFrontendStyleImports methods on PageTemplateHelper, respectively.

Tag helper changes

bool tag helper properties have been changed to bool?.
This is so that it's possible to differentiate between properties that have been explicitly initialized and those that have been left at the default values.
With this, other tag helpers or tag helper initializers can be created that assign default values to these properties.

Breaking changes

AddImportsToHtml

This option was used to automatically add style and JavaScript imports to all Razor views.
PageTemplateHelper and the _GovUkPageTemplate.cshtml layout view are better ways to generate a full page template now so this option, along with the backing tag helper component, have been removed.

Fixes

Page template

The og:image meta tag in the _GovUkPageTemplate.cshtml view is now an absolute URL.

Assets 2
Loading