postcss-unopacity
v2.0.0
Published
Use the opacity property in older Internet Explorer
Downloads
9,401
Readme
UnOpacity
UnOpacity lets you use the opacity
property in older Internet Explorer.
/* before */
.figure {
opacity: .5;
}
/* after */
.figure {
filter: alpha(opacity=50);
}
Usage
Add UnOpacity to your build tool:
npm install postcss-unopacity --save-dev
Node
Use UnOpacity to process your CSS:
require('postcss-unopacity').process(YOUR_CSS, { /* options */ });
PostCSS
Add PostCSS to your build tool:
npm install postcss --save-dev
Use UnOpacity as a plugin:
postcss([
require('postcss-unopacity')({ /* options */ })
]).process(YOUR_CSS, /* options */);
Gulp
Add Gulp PostCSS to your build tool:
npm install gulp-postcss --save-dev
Use UnOpacity in your Gulpfile:
var postcss = require('gulp-postcss');
gulp.task('css', function () {
return gulp.src('./src/*.css').pipe(
postcss([
require('postcss-unopacity')({ /* options */ })
])
).pipe(
gulp.dest('.')
);
});
Grunt
Add Grunt PostCSS to your build tool:
npm install grunt-postcss --save-dev
Use UnOpacity in your Gruntfile:
grunt.loadNpmTasks('grunt-postcss');
grunt.initConfig({
postcss: {
options: {
use: [
require('postcss-unopacity')({ /* options */ })
]
},
dist: {
src: '*.css'
}
}
});
Options
browsers
Type: String
| Array
Default: null
A list of browsers you want to target in your project. If no older Internet Explorer browsers are specified, this plugin will not make any changes to your CSS.
require('postcss-unopacity')({
browsers: ["> 1%", "last 2 versions", "Firefox ESR"]
})
This may also be defined in package.json
.
{
"browserslist": ["> 1%", "last 2 versions", "Firefox ESR"]
}
method
Type: String
Default: 'replace'
replace
Replace any opacity
property with a fallback.
/* before */
.figure {
opacity: .5;
}
/* after */
.figure {
filter: alpha(opacity=50);
}
copy
Copy any opacity
property with a fallback.
/* before */
.figure {
opacity: .5;
}
/* after */
.figure {
filter: alpha(opacity=50);
opacity: .5;
}
warn
Warn when an opacity
property is used.
prefixed
Type: Boolean
Default: false
true
Use an -ms-filter
property as a fallback.
/* before */
.figure {
opacity: .5;
}
/* after */
.figure {
-ms-filter: "progid:DXImageTransform.Microsoft.Alpha(Opacity=50)";
}
false
Use a filter
property as a fallback.
/* before */
.figure {
opacity: .5;
}
/* after */
.figure {
filter: alpha(opacity=50);
}