Releases: 18F/identity-design-system
Releases · 18F/identity-design-system
5.1.0
New Features
- Add support for SASS package entrypoints to limit or control loading of styles, similar to USWDS components. Available packages are
packages/required
,packages/global
,packages/components
, andpackages/utilities
. - The Side Navigation component is now documented and includes updated and improved styling. While this should not require any markup changes, you should validate that the updated styling does not conflict with any product-specific styles for side navigation.
Bug Fixes
- Reduce the border width of the normal outline button to the intended width of
1px
(previously2px
). The big variant of the outline button is unaffected by this change, and remains2px
. - Fix rounded corners on sidebar current page item.
- Fix unintentional rounded corners on search text field.
- Fix utility classes not always applying as expected when applied to components. For example, using
margin-
utility classes on an unstyled button would previously unexpectedly conflict with and not take precedent over the button's own margins. - Fix all instances of font weight appearance of unstyled buttons in content which applies anti-aliased font smoothing. Previous bug fix attempts had still missed default
:hover
and:active
states.
5.0.3
5.0.2
5.0.1
5.0.0
Breaking Changes
- Several button variants have been removed. These include:
- Success (
usa-button--success
) - Dropdown (
usa-button--dropdown
) - Small (
usa-button--small
) - Tiny (
usa-button--tiny
)
- Success (
- The Password Strength Meter component has been removed.
Improvements
- Link hover and active colors are now distinct.
- Before: Hover and active colors are both
primary-darker
. - After: Hover is
primary-dark
, and active isprimary-darker
.
- Before: Hover and active colors are both
- Improved support for "Unstyled" button variant (see documentation)
- Add three new button variants to control width:
usa-button--wide
displays a button at a wider (minimum) width at larger viewport displays.usa-button--flexible-width
displays a button at flexible width regardless of viewport size, and overrides default mobile appearance of full-width buttons.usa-button--full-width
displays a button at full width regardless of viewport size, and overrides default desktop appearance of flexible-width buttons.
Bug Fixes
- Fix an issue where focused buttons appear with a double focus ring style.
- Fix an issue where using the "auto" package entrypoint may cause components not to be loaded when used with some bundlers (e.g. Webpack).
Documentation
- Add documentation for "Big" button variants.
- Rename "Secondary" as "Outline" in buttons documentation.
4.0.0
Breaking Changes
- The Spinner button has been removed (
.usa-button__lg-invokeSpinner
). - Favicon images have been updated for consistency with the U.S. Web Design System. Existing references to
favicon-16x16.png
should be updated tofavicon-16.png
.favicon-32x32.png
has been removed. The closest substitute isfavicon-40.png
, at size 40 pixels x 40 pixels.
Improvements
- New favicon size variations are available. The complete set of pixel sizes are:
16
,40
,57
,72
,114
,144
,192
.
Bug Fixes
- Fix an issue where builds may produce styles in an unpredictable order.
- Fix an issue where
.usa-display
heading font size was rendered larger than intended. - Fix an issue where
dropdownButton
was using invalid CommonJS syntax when imported from ES module entrypoint. - Fix an issue where
.usa-prose
heading margins were not applied consistently. - Fix an issue where importing subpaths may not resolve correctly using native ES modules.
Internal
- Replace deprecated USWDS variable references with updated equivalent values.
3.0.0
Breaking Changes
- Updates USWDS from 2.0.3 to 2.9.0. Review release notes for specific changes which may apply. Specific impactful changes include...
- The Tooltip component is now inherited from USWDS, newly introduced as of USWDS 2.8.0. See component documentation for more information. The markup of this component is significantly different than that of the component previously implemented in the login.gov Design System.
- Due to a rounding precision fix, line-heights for text may appear larger than it had previously.
- Guidance for many components has been updated to improve accessibility and usability of markup. Neglecting to update this markup should not result in user-facing regressions, but you are recommended to update to improve end-user experience. Refer to the release notes and related component documentation for specifics:
- SVG images should include
role="img"
. - Numeric fields should use
type="text" inputmode="numeric"
instead oftype="number"
. - Search forms should assign
role="search"
to the form element. - Banner should be rendered as a
section
element instead of adiv
, and include a descriptivearia-label
. - Footer and hero content should include a descriptive
aria-label
. - Graphic list should use
h2
as a heading element instead ofh3
.
- SVG images should include
- "Official government website" banner text has been updated. Refer to USWDS guidance for updated markup.
New Features
- The published NPM package can now be imported into a project. Bundlers that support dead-code elimination (Webpack, etc.) can automatically remove unused code to optimize bundle size. See Usage guide for more information. Existing usage of JavaScript code from
dist/assets/
is unaffected by these changes.
Bug Fixes
- Fixed support for multiple dropdown buttons on a page.