/postcss-filter-gradient

PostCSS plugin for generating the old IE supported filter gradients

Primary LanguageJavaScriptMIT LicenseMIT

PostCSS Filter Gradient

PostCSS plugin for generating the old IE supported filter gradient.

Build Status

.foo {
    /* Input example */
    background: linear-gradient(to bottom, #1e5799, #7db9e8);
}
.foo {
    /* Output example */
    background: linear-gradient(to bottom, #1e5799, #7db9e8);
    filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff1e5799', endColorstr='#ff7db9e8', GradientType=0);
}

Install

npm install postcss-filter-gradient --save-dev

Usage

postcss([ require('postcss-filter-gradient') ])

Options

angleFallback

Default: true

IE filter doesn't support angular gradient. By default, when processing the angular gradient, we will convert the angle to its closest direction. You can disable this feature by setting this option to false.

Limitation

The IE filter gradient only support horizontal and vertical directions, and only support two colors. So, if there are more than two colors in the color stops, we only pick the first and the last one.

FAQ

Does it support legacy gradient syntax?

No. We only transform the standard linear-gradient syntax.

You can use the postcss-gradientfixer to unprefix it first.

Does it support angluar gradient?

Yes. This plugin only support deg unit. It will convert angular to the closest direction. For example, it convert 90deg to right and convert 10deg to top, positive angluar are also supported.

See PostCSS docs for examples for your environment.

CHANGELOG

LICENSE

MIT