postcss-will-change

PostCSS Will Change

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.

.foo {
  will-change: transform;
}

.foo {
  backface-visibility: hidden;
  will-change: transform;
}

Usage

Step 1: Install plugin:

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:

module.exports = {
  plugins: [
+   require('postcss-will-change'),
    require('autoprefixer')
  ]
}

Changelog

4.0.1

• Added funding links.

4.0

• Moved to PostCSS 8.
• Moved postcss to peerDependencies.

3.0

• Use PostCSS 7.
• Remove Node.js 4 support.

2.0

• Use PostCSS 6.

1.1

• Do not add backface-visibility if rule already has it (by Joe Lencioni).

1.0

• Use PostCSS 5.0 API.

0.2

• Support PostCSS 4.1 API.

0.1

• Initial release.