Introducing polished.js v4 beta!
We're super stoked to announce that polished.js v4 is officially in beta! It is available via your package manager of choice:
npm install polished@next
yarn add polished@next
- New Module:
important: Helper for targeting rules in a style block generated by polished modules that need !important-level specificity. Can optionally specify a rule (or rules) to target specific rules.
- New Modules:
easeInOut: Will replace
timingFunctionsto allow for smaller modules for specific use cases instead of the larger, more general original implementation. (#402)
Improvements & Bug Fixes
betweenImprovement: now properly throws an error when mixed units are used for from/toSize and min/maxScreen. This also fixes the same bug in
triangleImprovement: once again properly works with
inheritby setting individual properties when inherit is used. (#430)
stripUnitImprovement: now only does what it says on the tin: strips a unit from a provided CSS value. Typings are now appropriately set. (#451)
getValueAndUnitImprovement: canceled deprecation of this and it now does what it says on the tin: returns the value and unit as an array. Typings are now appropriately set. (#451)
ellipsisImprovement: now accepts a
linesparameter to truncate multi-line text.
timingFunctions: This will be deprecated in v5 in favor of
fontFace: default is now to look for a local font of the same family-name before downloading. Can be turned
off by passing
nullto localFonts. Previously, if
localFontswas not passed explcitily, it would never check.
passThroughin favor of being able to pass a
defaultValueto better mimic CSS variable functionality.
math: square root, factorial, and exponent have been moved to a separate symbol preset found at
math/presets/exponentialSymbols/. This can be passed a second parameter to
mathto restore this functionality.
readableColor: now defaults
- Testing: We've moved away from snapshot testing to explicit expects. This should be understanding if your tests are truly passing much easier.
- prettier: We've implemented
.prettierignoreto better control formatting in development environments.
- Build Speed: Build speed has been improved my removing extraneous linting scripts.
We are releasing this as a beta to allow the community to test the changes, and make any last-minute accommodations for the breaking changes. In the past, our biggest challenge with any new release has been typings. We are hoping this beta will allow those issues to be addressed before a full release. We expect this beta period to last around 2 weeks.
Coming In v5
v5 will be focused completely on size, speed, and documentation. The biggest change will be the move to submodules. Polished has grown into a large library of helpers, mixins, and color functions. We find ourselves limiting functionality in order to keep bundle size down. By moving to submodules we will be able to expand functionality without worrying about the size of the library and provide small bundle impacts for projects that don't implement tree-shaking. As part of this we will finally be revamping the docs to provide dedicated sections for each module with better usage examples.