Releases: styled-components/styled-components
v5.2.2
-
For React Native based components, pass
testID
down to the native component if specified for an easier time testing. (see #3365) -
Enable users of the babel macro to customize the styled-components import with
importModuleName
(see #3422) -
[fix] COMPLEX_SELECTOR_PREFIX.includes wasn't transpiled (see #3397)
v5.2.1
v5.2.0
-
Make sure
StyleSheetManager
renders all styles in iframe / child windows (see #3159) thanks @eramdam! -
Rework how components self-reference in extension scenarios (see #3236); should fix a bunch of subtle bugs around patterns like
& + &
-
Fix
keyframes
not receiving a modified stylis instance when using something likestylis-plugin-rtl
(see #3239) -
Big performance gain for components using style objects (see #3239)
-
We no longer emit dynamic classNames for empty rulesets, so some className churn may occur in snapshots
-
Preallocate global style placement to ensure cGS is consistently inserted at the top of the stylesheet; note that this is done in runtime order so, if you have multiple cGS that have overlapping styles, ensure they're defined in code in the sequence you would want them injected (see #3239)
-
Add "engines" to package.json (currently set to Node 10, the oldest supported LTS distribution) (see #3201) thanks @MichaelDeBoey!
Finally, special thanks to @willheslam for testing and some last minute fixes on this release!
v5.2.0-test.10
We are planning to release 5.2 on September 2/3, please help us test!
yarn add styled-components@test
-
Preallocate global style placement to ensure cGS is consistently inserted at the top of the stylesheet; note that this is done in runtime order so, if you have multiple cGS that have overlapping styles, ensure they're defined in code in the sequence you would want them injected (see #3239)
NOTE: This is a behavioral change and might require adjustment in your codebase if you have many
createGlobalStyle
components in use. We do not think it will affect the majority of projects other than fix existing bugs. -
createGlobalStyle
is nowReact.StrictMode
compliant -
Make sure
StyleSheetManager
renders all styles in iframe / child windows (see #3159) thanks @eramdam! -
Rework how components self-reference in extension scenarios (see #3236); should fix a bunch of subtle bugs around patterns like
& + &
-
Fix
keyframes
not receiving a modified stylis instance when using something likestylis-plugin-rtl
(see #3239) -
Big performance gain for components using style objects (see #3239)
-
We no longer emit dynamic classNames for empty rulesets, so some className churn may occur in snapshots
-
Add "engines" to package.json (currently set to Node 10, the oldest supported LTS distribution) (see #3201) thanks @MichaelDeBoey!
v5.1.1
New Functionality
- Implement
shouldForwardProp
API for native and primitive platforms, which was previously missing in [v5.1.0] (see #3093)
This has been released under a patch bump instead of a minor, since it's only been missing from Native-support.
Bugfixes
v5.1.0
New Functionality
-
Add
shouldForwardProp
API (almost the same as emotion's, just a slightly different usage pattern); #3006Sometimes when composing multiple higher-order components together, it's possible to get into scenarios when multiple layers consume props by the same name. In the past we've introduced various workarounds for popular props like
"as"
but this power-user API allows for more granular customization of what props are passed down to descendant component children when using thestyled()
HOC wrapper.When combined with other APIs like
.attrs()
this becomes a very powerful constellation of abilities.Here's how you use it:
const Comp = styled('div').withConfig({ shouldForwardProp: (prop, defaultValidatorFn) => !['filterThis'].includes(prop), })` color: red; `; render(<Comp filterThis="abc" passThru="def" />); # Renders: <div className="[generated]" passThru="def"></div>
The second argument
defaultValidatorFn
is what we use internally to validate props based on known HTML attributes. It's provided so you can filter exactly what props you don't wish to pass and then fall-back to the default filtering mechanism if desired.Other methods on the
styled
HOC like.attrs
can be chained afterwithConfig()
, and before opening your template literal:const Comp = styled('div').withConfig({ shouldForwardProp: (prop, defaultValidatorFn) => !['filterThis'].includes(prop), }).attrs({ className: 'foo' })` color: red; `; render(<Comp filterThis="abc" passThru="def" />); # Renders: <div className="[generated] foo" passThru="def"></div>
Thanks @stevesims and all that contributed!
-
Add "transient props" API; #3052
Think of transient props as a lightweight, but complementary API to
shouldForwardProp
. Because styled-components allows any kind of prop to be used for styling (a trait shared by most CSS-in-JS libraries, but not the third party library ecosystem in general), adding a filter for every possible prop you might use can get cumbersome.Transient props are a new pattern to pass props that are explicitly consumed only by styled components and are not meant to be passed down to deeper component layers. Here's how you use them:
const Comp = styled.div` color: ${props => props.$fg || 'black'}; `; render(<Comp $fg="red">I'm red!</Comp>);
Note the dollar sign (
$
) prefix on the prop; this marks it as transient and styled-components knows not to add it to the rendered DOM element or pass it further down the component hierarchy.
Bugfixes
-
Fix slow SSR Rehydration for malformed CSS and increase fault-tolerance (see #3018)
-
Change isPlainObject (internal method) to support objects created in a different context (see #3068) thanks @keeganstreet!
-
Add support for the
<video disablePictureInPicture>
(see #3058) thanks @egdbear!
v5.0.1
-
Added useTheme hook to named exports for react native (#2982)
-
Performance enhancements
-
Added some helpful new dev-time warnings for antipatterns
v5.0.0
It's finally here!!! 🚀See the migrating to v5 FAQ page for easy upgrade instructions!
Read the v5 release announcement!
TL;DR:
- 19% smaller bundle size
- 18% faster client-side mounting
- 17% faster updating of dynamic styles
- 45% faster server-side rendering
- RTL support
...and much more all, with no breaking changes!
NOTE: At this time we recommend not using @import
inside of createGlobalStyle
. We're working on better behavior for this functionality but it just doesn't really work at the moment and it's better if you just embed these imports in your HTML index file, etc.
Changes
-
StyleSheetManager
enhancements- you can now supply stylis plugins like stylis-plugin-rtl;
<StyleSheetManager stylisPlugins={[]}>...</StyleSheetManager>
disableVendorPrefixes
removes autoprefixing if you don't need legacy browser support;<StyleSheetManager disableVendorPrefixes>...</StyleSheetManager>
disableCSSOMInjection
forces using the slower injection mode if other integrations in your runtime environment can't parse CSSOM-injected styles;<StyleSheetManager disableCSSOMInjection>...</StyleSheetManager>
- you can now supply stylis plugins like stylis-plugin-rtl;
-
Removed the "subfunction" attrs syntax that was deprecated in v4
styled.div.attrs({ role: p => p.onClick ? 'button' : '' })` color: red; `
becomes
styled.div.attrs(p => ({ role: p.onClick ? 'button' : '' }))` color: red; `
-
Update css-to-react-native to v3.0.0 (#2811); the one breaking change noted is that unitless line height is no longer allowed when setting font properties
- if you get a lot of warnings at dev time from not having units in your styles, this codemod is available to help expedite updates: https://github.com/styled-components/styled-components-native-code-mod thanks @jacobp100
-
disallow /ad/i in generated class names (#2837); this change primarily helps to avoid some overly aggressive ad blockers that will mangle generated classnames containing the substring "ad"
-
if you use styled-components from CDN, in v5 the "react-is" dependency was added (make sure you add this to your project)
v5.0.0-rc.3
This should be the last RC before general v5 release in a week or two!
NOTE: If you've been testing this stylisPlugins
functionality with the stylis-rtl
plugin, please switch from stylis-rtl
to stylis-plugin-rtl
.
- make useTheme cleaner (#2879) props @sayjeyhi
- unnecessary flattening and interleave of css without interpolations @vepor
- switch back to mainline hoist-non-react-statics (#2934) …
- use funding field instead of post install script (#2931) props @koba04
- fix usage of nested stylesheetmanagers in SSR
- expose version in API (#2888) props @jamesarmenta
- refactor stylis management (#2936)
v5.0.0-rc.2
Note: we've switched from canary
to v5
as the target branch for the new release. It's basically the same, but fixed up so it'll merge cleanly onto master.
Changes from rc.1: