What is @csstools/postcss-color-mix-function?
@csstools/postcss-color-mix-function is a PostCSS plugin that allows you to use the CSS `color-mix()` function in your stylesheets. This function enables you to mix two colors together, which can be useful for creating color themes, gradients, and other visual effects.
What are @csstools/postcss-color-mix-function's main functionalities?
Mixing Two Colors
This feature allows you to mix two colors together using the `color-mix()` function. In this example, red and blue are mixed in equal proportions to produce a purple color.
/* Input CSS */
.example {
color: color-mix(in srgb, red 50%, blue);
}
/* Output CSS */
.example {
color: #800080;
}
Mixing Colors with Different Percentages
This feature allows you to specify different percentages for each color in the mix. In this example, red is given a 70% weight and blue a 30% weight, resulting in a reddish-purple color.
/* Input CSS */
.example {
color: color-mix(in srgb, red 70%, blue 30%);
}
/* Output CSS */
.example {
color: #b3004d;
}
Using Different Color Spaces
This feature allows you to mix colors in different color spaces. In this example, the colors are mixed in the LCH color space, which can produce different results compared to the default sRGB color space.
/* Input CSS */
.example {
color: color-mix(in lch, red 50%, blue);
}
/* Output CSS */
.example {
color: #a2007d;
}
Other packages similar to @csstools/postcss-color-mix-function
postcss-color-function
The `postcss-color-function` package allows you to use color functions like `color()` in your CSS. It provides similar functionality to `@csstools/postcss-color-mix-function` but focuses on a broader range of color manipulations, not just mixing.
postcss-preset-env
The `postcss-preset-env` package includes a variety of modern CSS features, including color manipulation functions. It is more comprehensive than `@csstools/postcss-color-mix-function` as it aims to polyfill many CSS features, not just color mixing.
postcss-advanced-variables
The `postcss-advanced-variables` package allows you to use Sass-like variables and functions in your CSS, including color functions. It provides a broader set of features for CSS preprocessing compared to the more focused `@csstools/postcss-color-mix-function`.
PostCSS Color Mix Function ![PostCSS Logo](https://postcss.github.io/postcss/logo.svg)
![Discord](https://shields.io/badge/Discord-5865F2?logo=discord&logoColor=white)
![CSS Standard Status](https://cssdb.org/images/badges/color-mix.svg)
npm install @csstools/postcss-color-mix-function --save-dev
PostCSS Color Mix Function lets you use the color-mix()
function following the CSS Color 5 Specification.
.purple_plum {
color: color-mix(in lch, purple 50%, plum 50%);
}
/* becomes */
.purple_plum {
color: rgb(175, 92, 174);
}
[!NOTE]
We can not dynamically resolve var()
arguments in color-mix()
, only static values will work.
Usage
Add PostCSS Color Mix Function to your project:
npm install postcss @csstools/postcss-color-mix-function --save-dev
Use it as a PostCSS plugin:
const postcss = require('postcss');
const postcssColorMixFunction = require('@csstools/postcss-color-mix-function');
postcss([
postcssColorMixFunction()
]).process(YOUR_CSS );
PostCSS Color Mix Function runs in all Node environments, with special
instructions for:
Options
preserve
The preserve
option determines whether the original notation
is preserved. By default, it is not preserved.
postcssColorMixFunction({ preserve: true })
.purple_plum {
color: color-mix(in lch, purple 50%, plum 50%);
}
/* becomes */
.purple_plum {
color: rgb(175, 92, 174);
color: color-mix(in lch, purple 50%, plum 50%);
}