大网数据广告活动
Web 标准与前端开发

`<hue>` CSS type

· 52CE 我爱测

The **`<hue>`** CSS data type represents the hue angle of a color. It is used in the color functions that accept hue expressed as a single value, specifically `hsl()`, `hwb()`, `lch()`, and `oklch()` functional notations.

The <hue> CSS data type represents the hue angle of a color. It is used in the color functions that accept hue expressed as a single value, specifically hsl(), hwb(), lch(), and oklch() functional notations.

Syntax

A <hue> can be either an <angle> or a <number>.

Values

  • angle
    • : An angle expressed in degrees, gradians, radians, or turns using the deg, grad, rad, or turn, respectively.
  • <number>
    • : A real number, representing degrees of the hue angle.

As an <angle> is periodic, <hue> is normalized to the range [0deg, 360deg). It implicitly wraps around such that 480deg is the same as 120deg, -120deg is the same as 240deg, -1turn is the same as 1turn, and so on.

Description

An sRGB color wheel

The color wheel above shows hues at all angles in the sRGB color space. In particular, red is at 0deg, yellow is at 60deg, lime is at 120deg, cyan is at 180deg, blue is at 240deg, and magenta is at 300deg.

The angles corresponding to particular hues differ depending on the color space. For example, the hue angle of sRGB green is 120deg in the sRGB color space, but 134.39deg in the CIELAB color space.

The following table lists typical colors at various angles in the sRGB (used by color_value/hsl and color_value/hwb), CIELAB (used by color_value/lch), and Oklab (used by color_value/oklch) color spaces:

<table> <colgroup> <col /> <col span="6" width="15%" /> </colgroup> <thead> <tr> <th></th> <th scope="col">0°</th> <th scope="col">60°</th> <th scope="col">120°</th> <th scope="col">180°</th> <th scope="col">240°</th> <th scope="col">300°</th> </tr> </thead> <tbody> <tr> <th scope="row">sRGB</th> <td style="background: hsl(0 100% 50%);" title="hsl(0 100% 50%)"></td> <td style="background: hsl(60 100% 50%);" title="hsl(60 100% 50%)"></td> <td style="background: hsl(120 100% 50%);" title="hsl(120 100% 50%)"></td> <td style="background: hsl(180 100% 50%);" title="hsl(180 100% 50%)"></td> <td style="background: hsl(240 100% 50%);" title="hsl(240 100% 50%)"></td> <td style="background: hsl(300 100% 50%);" title="hsl(300 100% 50%)"></td> </tr> <tr> <th scope="row">CIELAB</th> <td style="background: lch(50% 50% 0);" title="lch(50% 50% 0)"></td> <td style="background: lch(65% 55% 60);" title="lch(65% 55% 60)"></td> <td style="background: lch(90% 65% 120);" title="lch(90% 65% 120)"></td> <td style="background: lch(90% 35% 180);" title="lch(90% 35% 180)"></td> <td style="background: lch(75% 25% 240);" title="lch(75% 25% 240)"></td> <td style="background: lch(40% 70% 300);" title="lch(40% 70% 300)"></td> </tr> <tr> <th scope="row">Oklab</th> <td style="background: oklch(65% 65% 0);" title="oklch(65% 65% 0)"></td> <td style="background: oklch(75% 40% 60);" title="oklch(75% 40% 60)"></td> <td style="background: oklch(90% 50% 120);" title="oklch(90% 50% 120)"></td> <td style="background: oklch(90% 35% 180);" title="oklch(90% 35% 180)"></td> <td style="background: oklch(70% 40% 240);" title="oklch(70% 40% 240)"></td> <td style="background: oklch(55% 70% 300);" title="oklch(55% 70% 300)"></td> </tr> </tbody> </table>

Interpolation of <hue> values

<hue> values are interpolated as angle values, and the default interpolation algorithm is shorter. In some color-related CSS functions, this can be overridden by the <hue-interpolation-method> component.

Formal syntax

Examples

Changing the hue of a color using a slider

The following example shows the effect of changing the hue value of the hsl() functional notation on a color.

HTML

<input type="range" min="0" max="360" value="0" id="hue-slider" />
<p>Hue: <span id="hue-value">0deg</span></p>
<div id="box"></div>

CSS

div {
  width: 100px;
  height: 100px;
  margin: 10px;
  border: 1px solid black;
}
p {
  font-family: sans-serif;
}
span {
  font-family: monospace;
  background: rgb(0 0 0 / 10%);
  padding: 3px;
}
#hue-slider {
  width: 90%;
}
#box {
  background-color: hsl(0 100% 50%);
}

JavaScript

const hue = document.querySelector("#hue-slider");
const box = document.querySelector("#box");
hue.addEventListener("input", () => {
  box.style.backgroundColor = `hsl(${hue.value} 100% 50%)`;
  document.querySelector("#hue-value").textContent = `${hue.value}deg`;
});

Result

changing_the_hue_of_a_color_using_a_slider

Approximating red hues in different color spaces

The following example shows a similar red color in different color spaces. The values in the lch() and oklch() functions are rounded for readability.

HTML

<div data-color="hsl-red">hsl()</div>
<div data-color="hwb-red">hwb()</div>
<div data-color="lch-red">lch()</div>
<div data-color="oklch-red">oklch()</div>

CSS

[data-color="hsl-red"] {
  /* hsl(<hue> <saturation> <lightness>) */
  background-color: hsl(0 100% 50%);
}
[data-color="hwb-red"] {
  /* hwb(<hue> <whiteness> <blackness>) */
  background-color: hwb(0 0% 0%);
}
[data-color="lch-red"] {
  /* lch(<lightness> <chroma> <hue>) */
  background-color: lch(50 150 40);
}
[data-color="oklch-red"] {
  /* oklch(<lightness> <chroma> <hue>) */
  background-color: oklch(0.6 0.4 20);
}
div {
  font-family: monospace;
  width: 100px;
  height: 100px;
  margin: 10px;
  border: 1px solid black;
  display: inline-block;
}

Result

approximating_red_hues_in_different_color_spaces

Specifications

Browser compatibility

See also

  • <color>
  • <hue-interpolation-method>

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。