palette-mix()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The palette-mix() CSS function can be used to create a new font-palette value by blending together two font-palette values by specified percentages and color interpolation methods.
Syntax
/* Blending font-defined palettes */
font-palette: palette-mix(in lch, normal, dark)
/* Blending author-defined palettes */
font-palette: palette-mix(in lch, --blues, --yellows)
/* Varying percentage of each palette mixed */
font-palette: palette-mix(in lch, --blues 50%, --yellows 50%)
font-palette: palette-mix(in lch, --blues 70%, --yellows 30%)
/* Varying color interpolation method */
font-palette: palette-mix(in srgb, --blues, --yellows)
font-palette: palette-mix(in hsl, --blues, --yellows)
font-palette: palette-mix(in hsl shorter hue, --blues, --yellows)
Values
Functional notation:
palette-mix(method, palette1 [p1], palette2 [p2])
method-
A
<color-interpolation-method>specifying the interpolation color space. palette1,palette2-
The
font-palettevalues to blend together. These can be anyfont-palettevalues, includingpalette-mix()functions,normal,dark, andlight. p1,p2Optional-
<percentage>values between0%and100%specifying the amount of each palette to mix. They are normalized as follows:- If both
p1andp2are omitted, thenp1 = p2 = 50%. - If
p1is omitted, thenp1 = 100% - p2. - If
p2is omitted, thenp2 = 100% - p1. - If
p1 = p2 = 0%, the function is invalid. - If
p1 + p2 ≠ 100%, thenp1' = p1 / (p1 + p2)andp2' = p2 / (p1 + p2), wherep1'andp2'are the normalization results.
- If both
Examples
Using palette-mix() to blend two palettes
This example shows how to use the palette-mix() function to create a new palette by blending two others.
HTML
The HTML contains three paragraphs to apply our font information to:
<p class="yellowPalette">Yellow palette</p>
<p class="bluePalette">Blue palette</p>
<p class="mixedPalette">Mixed palette</p>
CSS
In the CSS, we import a color font from Google Fonts, and define two custom font-palette values using the @font-palette-values at-rule. We then apply three different font-palette values to the paragraphs — --yellow, --blue, and a new green palette, created using palette-mix() to blend the blue and yellow palettes together.
@import url("https://fonts.googleapis.com/css2?family=Nabla&display=swap");
@font-palette-values --blueNabla {
font-family: Nabla;
base-palette: 2; /* this is Nabla's blue palette */
}
@font-palette-values --yellowNabla {
font-family: Nabla;
base-palette: 7; /* this is Nabla's yellow palette */
}
p {
font-family: "Nabla";
font-size: 4rem;
text-align: center;
margin: 0;
}
.yellowPalette {
font-palette: --yellowNabla;
}
.bluePalette {
font-palette: --blueNabla;
}
.mixedPalette {
font-palette: palette-mix(in lch, --blueNabla 55%, --yellowNabla 45%);
}
Result
The output looks like this:
Specifications
| Specification |
|---|
| CSS Fonts Module Level 4 # typedef-font-palette-palette-mix |
Browser compatibility
| desktop | mobile | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
palette-mix() | |||||||||||
See also
font-palette@font-palette-valuescolor-mix()- Color spaces and color models for information about color spaces