Publish - August 30th, 2021
Summary
We've removed utility classes from being used in the components. We had some typography updates, and flipped the accordion arrow icon. The angular code dependency has been updated to support 11. We updated the angular storybook and it now uses inline rendering which makes the Docs page load much faster.
❗️ This release is medium-large. Depending on the app.
Allocate Dev and Design time accordingly and refer to the Upgrade Guide at the bottom of these release notes for project scope. The largest efforts are checking your entire app for any visual changes upon upgrading.
Package Versions
- Angular: 14.0.0 -> 15.0.0
- React: 6.0.0 -> 7.0.0
- Spark (HTML): 17.0.0 -> 18.0.0
- Styles: 3.0.0 -> 4.0.0
All packages
- 🚨 Removes the use of utility classes from Spark, this touches all three frameworks and is a breaking change because we removed the use of
!important
from components and added some new classes. - 📌 This release includes minor adjustments to typography settings throughout Spark. Text in every component will have been slightly modified in terms of line height, font size, and/or font weight. Be sure to review your application thoroughly to make sure all text content is still usable.
- Flip accordion arrow icon & add additional class for optional top border #4039
- Input labels, spacing and copy in Storybook are now consistent with each other.
- There is a space for App Store Badges in the Footer:
- Typography updates, and a new documentation page.
- Select component's icon position is set to
relative
so it's visible if there's an autofill present.
Angular
- Upgrade Angular Storybook to latest version. Check it out!
- Removes the use of utility classes from Spark, this touches all three frameworks and is a breaking change because we removed the use of
!important
from components and added some new classes. - Add App Store links in the footer with the new
app-slot
isElementVisible
function is now checking ifwindow
isundefined
. This makes sure that errors don't show up. Affects Autocomplete, and Masthead components.- For those needing a more custom Footer Award section, use the new
additional-award-slot
- Typography updates, and a new documentation page.
- Updates peer dependencies to be up to Angular 11.2.14.
- Select component's icon position is set to
relative
.
React
- Removes the use of utility classes from Spark, this touches all three frameworks and is a breaking change because we removed the use of
!important
from components and added some new classes. - A new prop to
SprkStack
calledisStackItem
. Set totrue
will add the stack item class in cases where you need your Stack to also be an Stack Item. - New
app-slot
prop is available to pass in into Footer. - 📌 Helper text elements are not
<p>
tags instead of<div>
tags for better semantics. - Typography updates, and a new documentation page.
HTML
- Removes the use of utility classes from Spark, this touches all three frameworks and is a breaking change because we removed the use of
!important
from components and added some new classes. isElementVisible
function is now checking ifwindow
isundefined
. This makes sure that errors don't show up. Affects Autocomplete, and Masthead
Styles
- Added new modifier to Stack of
/// Centers children of the Stack.
.sprk-o-Stack--center-all {
align-items: center;
justify-content: center;
}
- Added new type helpers
// Type Helpers
.sprk-b-Type--center {
text-align: $sprk-type-center;
}
.sprk-b-Type--left {
text-align: $sprk-type-left;
}
.sprk-b-Type--right {
text-align: $sprk-type-right;
}
Upgrade Guide
HTML
- Typography updates may shift some elements in your app. Do a visual check and adjust accordingly.
- Find Dropdown instances by searching the project for
sprk-c-Dropdown
. If there issprk-u-Display--none
utility class, remove and replace withsprk-c-Dropdown--is-hidden
. - Find Modal instances by searching the project for
sprk-c-Modal
. If there issprk-u-Display--none
utility class, remove and replace withsprk-c-Modal--is-hidden
. You may also need to look forsprk-c-ModalMask
and replacesprk-u-Display--none
withsprk-c-ModalMask--is-hidden
. - Update the Masthead code to match our copy code. 🚨 We removed a handful of utility classes like
sprk-u-Display--none
that used!important
and replaced them. See all of the main difference in the Pull Request.
Angular
- Typography updates may shift some elements in your app. Do a visual check and adjust accordingly.
- Improve your code semantics by searching for
sprkHelperText
directives and turning it into a<p>
if appropriate. - 🚨 We removed many utility classes from components and stories. These classes had
!important
on them and overid styles. Do a visual check on your app to make sure that unintended styles aren't applying because of this removal. Explore our PR and take a look at the stories.
React
- Typography updates may shift some elements in your app. Do a visual check and adjust accordingly.
- 🚨 We removed many utility classes from components and stories. These classes had
!important
on them and overid styles. Do a visual check on your app to make sure that unintended styles aren't applying because of this removal. Explore our PR and take a look at the stories. - If you have custom styling by selecting css via the
.sprk-b-HelperText
class, also make sure you're not selecting via a<div>
element. It's a<p>
tag now.