`hue-rotate()` CSS function
The hue-rotate() CSS function rotates the hue of an element and its contents. It is used as a value for the filter and backdrop-filter properties.
The hue-rotate() CSS function rotates the hue of an element and its contents. It is used as a value for the filter and backdrop-filter properties.
[!NOTE]
hue-rotate()is specified as a matrix operation on the RGB color. It does not actually convert the color to the HSL model, which is a non-linear operation. Therefore, it may not preserve the saturation or lightness of the original color, especially for saturated colors.
CSS Demo: hue-rotate()
```css interactive-example-choice filter: hue-rotate(0);
```css interactive-example-choice
filter: hue-rotate(90deg);
```css interactive-example-choice filter: hue-rotate(-0.25turn);
```css interactive-example-choice
filter: hue-rotate(3.142rad);
```html interactive-example
## Syntax
```css
/* No rotation */
hue-rotate()
hue-rotate(0deg)
/* Half-turn rotation */
hue-rotate(-180deg)
hue-rotate(540deg)
hue-rotate(200grad)
hue-rotate(3.14159rad)
hue-rotate(0.5turn)
Parameters
- angle
- : Specifies the relative change in hue of the input sample. A value of
0degleaves the input unchanged. A positive hue rotation increases the hue value, while a negative rotation decreases the hue value. The initial value for interpolation is0. There is no minimum or maximum value. Givenhue-rotate(Ndeg), the effect evaluates toNmodulo 360. The default value is0deg.
Return value
A filter-function value.
Formal syntax
Examples
With the backdrop-filter property
This example applies a hue-rotate() filter via the backdrop-filter CSS property to the paragraph, color shifting to the area behind the <p>.
.container {
background: url("/shared-assets/images/examples/listen_to_black_women.jpg")
no-repeat left / contain #011296;
}
p {
backdrop-filter: hue-rotate(240deg);
text-shadow: 2px 2px #011296;
}
```css hidden .container { padding: 3rem; width: 30rem; } p { padding: 0.5rem; color: white; font-size: 2rem; font-family: sans-serif; }
```html hidden
<div class="container">
<p>
Text on images can be illegible and inaccessible even with a drop shadow.
</p>
</div>
100%
With the filter property
This example applies a hue-rotate() filter via the filter CSS property adding the color shift to the entire element, including content, border, and background image.
p {
filter: hue-rotate(-60deg);
text-shadow: 2px 2px blue;
background-color: magenta;
color: goldenrod;
border: 1em solid rebeccapurple;
box-shadow:
inset -5px -5px red,
5px 5px yellow;
}
```css hidden p { padding: 0.5rem; font-size: 2rem; font-family: sans-serif; width: 85vw; }
```html hidden
<p>The person who wrote this example is not a designer, fortunately.</p>
100%
Using the SVG filter
This example shows three images for comparison: an image with a hue-rotate() filter function applied, an image with the equivalent SVG filter applied, and the original image.
SVG
The SVG feColorMatrix filter element can also be used to rotate the hue of content. We set the type to hueRotate and the values to the angle in degrees, then we can reference the SVG effect by the ID of the filter:
```html live-sample___svg-filter
The following declarations produce the same effect:
```css
filter: hue-rotate(90deg);
filter: url("#hue-rotate90"); /* with embedded SVG */
filter: url("fileName.svg#hue-rotate90"); /* external SVG */
CSS
We include CSS that will rotate the hue of elements based on their css-filter or svg-filter class:
```css live-sample___svg-filter .css-filter { filter: hue-rotate(90deg); }
.svg-filter { filter: url("#hue-rotate90"); }
```css hidden live-sample___svg-filter
th,
td {
padding: 5px;
}
```html hidden live-sample___svg-filter
hue-rotate() filter |
SVG filter equivalent | Original image |
|---|---|---|
|
|
|
100%
### hue-rotate() does not preserve saturation or lightness
The diagram below compares two color gradients starting with red: the first is generated using `hue-rotate()`, and the second uses actual HSL color values. Note how the `hue-rotate()` gradient shows obvious differences in saturation and lightness in the middle.
```html
<div>
<p>Using <code>hue-rotate()</code></p>
<div id="hue-rotate"></div>
</div>
<div>
<p>Using <code>hsl()</code></p>
<div id="hsl"></div>
</div>
```css hidden
hue-rotate,
hsl {
display: flex; margin: 1em 0; }
hue-rotate div,
hsl div {
width: 2px; height: 100px; }
```js
const hueRotate = document.getElementById("hue-rotate");
const hsl = document.getElementById("hsl");
for (let i = 0; i < 360; i++) {
const div1 = document.createElement("div");
div1.style.backgroundColor = `hsl(${i}, 100%, 50%)`;
hsl.appendChild(div1);
const div2 = document.createElement("div");
div2.style.backgroundColor = "red";
div2.style.filter = `hue-rotate(${i}deg)`;
hueRotate.appendChild(div2);
}
100%
Specifications
Browser compatibility
See also
- CSS filter effects module
- The other filter-function functions available to be used in values of the filter and backdrop-filter properties include:
- blur()
- brightness()
- contrast()
- drop-shadow()
- grayscale()
- invert()
- opacity()
- saturate()
- sepia()