summaryrefslogtreecommitdiff
path: root/node_modules/postcss-will-change/README.md
diff options
context:
space:
mode:
authorlittleblack111 <littleblack11111@gmail.com>2023-10-14 15:20:49 +0800
committerlittleblack111 <littleblack11111@gmail.com>2023-10-14 15:20:49 +0800
commitc5a5384e846f242e901e859fe600d695d8990a9a (patch)
tree079d4ccf2ed93dc1f0cae74a6d3b4a42ac387ece /node_modules/postcss-will-change/README.md
parentd261b7aafee0e6e5c7b853cb8dfe609cc0a0ac9e (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.md69
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