Releases: 18F/identity-design-system
Releases · 18F/identity-design-system
9.4.0
9.3.0
Improvements
- Update styling for Default (previously "Other") Alert component variant, for greater distinction from other variants and consistency with U.S. Web Design System. (#449)
- It is no longer necessary to assign the
usa-alert--otherclass to use these styles, and it can be safely removed. Existing code assigningusa-alert--othershould continue to display the updated default styles as expected.
- It is no longer necessary to assign the
Bug Fixes
- Improve compatibility of badge icon styling for inner Icon component. (#445)
- Improve text contrast for code syntax highlighting. (!2)
Dependencies
- Upgrade USWDS from v3.8.0 to v3.8.1 (see release notes) (#448)
9.2.0
Improvements
- Update styling for Alert component for increased contrast and consistency with U.S. Web Design System. (#439)
- Update styling for Validation component icons for consistency with U.S. Web Design System. (#441)
- Update markup for badge component to use U.S. Web Design System icons. (#442)
- Existing usage will not be affected until the next major release (see "Deprecations").
Deprecations
- Badge component markup has been updated and will be required in the next major release. (#442)
- Custom alert icons will be removed in the next major release, use U.S. Web Design System alerts instead.
alerts/error.svgalerts/info.svgalerts/success.svgalerts/unphishable.svgalerts/warning.svg
9.1.0
New Features
Improvements
- Update styling for Tag component for consistency with U.S. Web Design System. (#426)
- Hide collapsed Accordion component content while JavaScript loads. (#434)
Dependencies
- Upgrade USWDS from v3.7.1 to v3.8.0 (see release notes) (#425)
9.0.0
Breaking Changes
- Prose styling overrides have been removed. Text formatting should now adhere to the defaults from the U.S. Web Design System. (#390)
- Drop support for Internet Explorer. (#387)
- Support was indirectly dropped in v7.0.0 via the upgrade to USWDS v3.0.0, which similarly ended explicit support for Internet Explorer. This package had continued to include Internet Explorer in its Browserslist configuration, but this has now been removed.
- Remove utility classes for raw color tokens. (#405)
- These colors were usually incorrect because they were using U.S. Web Design System defaults instead of the Login.gov Design System color set.
- In most common cases, these should be replaced with stateful equivalents ("success" instead of "green") or theme colors ("base" instead of "gray-50").
- Applies to the following utilities:
- Background color (
bg-*) - Border color (
border-*) - Text color (
text-*) - Outline color (
outline-*) - Text underline color (
underline-*)
- Background color (
- The following colors are removed:
red(useerrorinstead)orangegoldyellow(usewarninginstead)green(usesuccessinstead)mintcyanblue(useprimaryinstead)indigovioletmagentagray-10(usebase-lighterinstead)gray-30(usebase-lightinstead)gray-50(usebaseinstead)gray-70(usebase-darkerinstead)gray-90(usebase-darkestinstead)
- Remove images not integral to the design system. (#410)
- If you use any of these images, consider proposed alternatives below, or copy the image from the previous release into your project:
illustrations/fail.svg(legacy alert icon, new alert icons will be introduced in a future release)illustrations/security-key.svgangle-arrow-down-white-hover.svg(useexpand_moreicon instead)angle-arrow-down-white.svg(useexpand_moreicon instead)angle-arrow-down.svg(useexpand_moreicon instead)angle-arrow-up-white-hover.svg(useexpand_lessicon instead)angle-arrow-up-white.svg(useexpand_lessicon instead)angle-arrow-up.svg(useexpand_lessicon instead)close-primary.svg(usecloseicon instead)close.svg(usecloseicon instead)hero.png
- If you use any of these images, consider proposed alternatives below, or copy the image from the previous release into your project:
- Align JavaScript component names with U.S. Web Design System. (#414)
headeris now namednavigationvalidationis now namedvalidator
Improvements
- Optimize images to reduce their size. (#411)
- Browser-ready JavaScript bundles are now minified. (#421)
New Features
- Add TypeScript types for JavaScript components. (#413)
- Include
init.jsas both a package entrypoint and precompiled asset withindist/assets/js, which provides the functionality of U.S. Web Design System'suswds-init.jsscript to reduce the appearance of flashing content during page load. See README Browser-Ready JavaScript Bundles for usage instructions. (#421)
Bug Fixes
- Add missing JavaScript exports for
button,inPageNavigation,inputMask,languageSelector, andrange. (#407) - Fix
dist/assets/js/main.jscompilation to properly consider browser support. (#421) - Fix strict ES Module import errors due to lack of fully-qualified file path when importing
autoentrypoint. (#422) - Fix background color when hovering an expanded navigation section on large viewport sizes. (#418)
Internal
- Replace code compiler Babel with ESBuild. (#387)
- This is not expected to have a downstream impact, but there may be subtle differences in the compiled code due to this change.
8.1.2
9.0.0-beta.2
Bug Fixes
- Fix strict ES Module import errors due to lack of fully-qualified file path. (#400)
9.0.0-beta.1
Breaking Changes
- Prose styling overrides have been removed. Text formatting should now adhere to the defaults from the U.S. Web Design System.
- Drop support for Internet Explorer. (#387)
- Support was indirectly dropped in v7.0.0 via the upgrade to USWDS v3.0.0, which similarly ended explicit support for Internet Explorer. This package had continued to include Internet Explorer in its Browserslist configuration, but this has now been removed.
Internal
- Replace code compiler Babel with ESBuild. (#387)
- This is not expected to have a downstream impact, but there may be subtle differences in the compiled code due to this change.
8.1.1
8.1.0
New Features
- Add variant support for danger outline buttons. (#383)
Bug Fixes
- Improve consistency with USWDS disabled buttons styles. (#383)
- USWDS v3.5.0 removed
.usa-button--disabledstyling in favor of[aria-disabled="true"]. This wasn't documented as a breaking change, and it's expected the any.usa-button--disabledusage would not be stylized correctly since those changes. You should replace any usage ofusa-button--disabledwith either the[disabled]or[aria-disabled="true"]attributes.
- USWDS v3.5.0 removed