1.0.0
This is the first official release of the CMS Design System. Future releases will conform to the Semantic Versioning as outlined here.
🚀 Added
- Added a
flex-wrap
utility class - Added a
$ds-include-base-html-rulesets: true
Sass variable which, when set tofalse
, will disable the base HTML selectors. (Onlya {...}
right now — see below) - Added
SkipNav
CSS and React component
🚨 Breaking changes
- Added styling to base
<a>
elements (More info here: #106) - Renamed
ds-c-vertical-nav__link
tods-c-vertical-nav__label
to more accurately represent its functionality — it can be used on more than just<a>
tags. (#116) - Changed both the default font and image paths so that their directories are now expected to live in the same directory as the CSS's directory. This is actually what the U.S. WDS does, so it's a reversion of customizations we made early on. The expected file structure is now:
To restore the previous behavior, you could define the following variables before the line where you
├── Assets directory/ ├── css/ # The CSS directory can be named whatever you want. ├── images/ └── fonts/
@import
the design system's Sass file:$font-path: 'fonts'; $image-path: 'images'; @import '@cmsgov/design-system-core';
- Moved the
fonts
andimages
directories to the root ofpackages/core
, moving them out of thedist
andsrc
directories.
💅 Changes
-
ds-u[-*]-justify-content*
,ds-u[-*]-align-items*
, andds-u[-*]-flex-wrap*
now use!important
s when setting properties. -
ds-display
andds-title
will now drop down to the font-size ofds-h1
on small screens. This is similar to what USWDS does and saves the trouble of doing this yourself during implementation, which you'd likely need to do. -
When a Vertical Nav item includes a sub-navigation menu, the user can now toggle the sub-nav by clicking anywhere on the label. Before, they had to click the arrow icon, which was pretty annoying. Below is a visual comparison of the functionality:
Before After
🛠 Fixed
- Fixed unexpected flexbox grid column behavior caused by the default
min-width
value of flexbox items being set toauto
. This could result in a grid column overflowing the viewport on the x-axis, rather than resizing to fit within the viewport as you'd expect. For more context, check out this article.