@csstools/postcss-color-mix-function

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`.

README

PostCSS Color Mix Function

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(/* pluginOptions */)
]).process(YOUR_CSS /*, processOptions */);

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%);
}