diff options
| author | littleblack111 <littleblack11111@gmail.com> | 2023-10-14 15:20:49 +0800 |
|---|---|---|
| committer | littleblack111 <littleblack11111@gmail.com> | 2023-10-14 15:20:49 +0800 |
| commit | c5a5384e846f242e901e859fe600d695d8990a9a (patch) | |
| tree | 079d4ccf2ed93dc1f0cae74a6d3b4a42ac387ece /node_modules/postcss-will-change/README.md | |
| parent | d261b7aafee0e6e5c7b853cb8dfe609cc0a0ac9e (diff) | |
legacy browser support via plugins from postcss
Diffstat (limited to 'node_modules/postcss-will-change/README.md')
| -rw-r--r-- | node_modules/postcss-will-change/README.md | 69 |
1 files changed, 69 insertions, 0 deletions
diff --git a/node_modules/postcss-will-change/README.md b/node_modules/postcss-will-change/README.md new file mode 100644 index 00000000..515f9a55 --- /dev/null +++ b/node_modules/postcss-will-change/README.md @@ -0,0 +1,69 @@ +# PostCSS Will Change + +<img align="right" width="135" height="95" + title="Philosopher’s stone, logo of PostCSS" + src="https://postcss.org/logo-leftp.svg"> + +[PostCSS] plugin to insert 3D hack before [will-change] property. + +This plugin uses `backface-visibility` to force the browser to create +a new layer, without overriding existing `backface-visibility` properties. +This 3D CSS hack is commonly done with `transform: translateZ(0)`, +but `backface-visibility` is used here to avoid overriding +the more popular `transform` property. + +These hacks are required for browsers that do not support `will-change`. + +Use this plugin only before [Autoprefixer]. It will add vendor prefixes +to `backface-visibility`. + +[Autoprefixer]: https://github.com/postcss/autoprefixer +[will-change]: https://dev.opera.com/articles/css-will-change-property/ +[PostCSS]: https://github.com/postcss/postcss + +```css +.foo { + will-change: transform; +} +``` + +```css +.foo { + backface-visibility: hidden; + will-change: transform; +} +``` + +<a href="https://evilmartians.com/?utm_source=postcss-will-change"> + <img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" + alt="Sponsored by Evil Martians" width="236" height="54"> +</a> + + +## Usage + +**Step 1:** Install plugin: + +```sh +npm install --save-dev postcss postcss-will-change +``` + +**Step 2:** Check you project for existed PostCSS config: `postcss.config.js` +in the project root, `"postcss"` section in `package.json` +or `postcss` in bundle config. + +If you do not use PostCSS, add it according to [official docs] +and set this plugin in settings. + +**Step 3:** Add the plugin to plugins list: + +```diff +module.exports = { + plugins: [ ++ require('postcss-will-change'), + require('autoprefixer') + ] +} +``` + +[official docs]: https://github.com/postcss/postcss#usage |
