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

hsl()

· 52CE 我爱测

**`hsl()`** 函数标记根据其*色相*、*饱和度*和*明度*来表达 RGB 颜色。可选的 _alpha_ 成分代表了颜色的透明度。

hsl() 函数标记根据其色相、饱和度和明度来表达 RGB 颜色。可选的 alpha 成分代表了颜色的透明度。

[!NOTE] 旧版的 hsla() 语法是 hsl() 的别称,接收相同的参数,行为也是相同的。

CSS Demo: hsl()

background: hsl(50 80% 40%);
background: hsl(150deg 30% 60%);
background: hsl(0.3turn 60% 45% / 0.7);
background: hsl(0 80% 50% / 25%);
<section id="default-example">
  <div class="transition-all" id="example-element"></div>
</section>
#example-element {
  min-width: 100%;
  min-height: 100%;
  padding: 10%;
}

使用 hsl() 来定义互补色可以用一个公式来完成,因为它们位于color wheel中同一直径上。如果一个颜色的色相度是 θ,那么其互补色的色相角就是 180deg - θ。

语法

hsl(120deg 75% 25%)
hsl(120deg 75% 25% / 0.6)

此函数也接受旧版的语法,即所有的值都是用逗号分隔的。

值

函数标记:hsl(H S L[ / A])

  • H
    • : <number>、<angle> 或者关键字 none,代表色相角。关于此类型的更多细节可以参见 <hue> 文档。
  • S
    • : <percentage> 或者关键字 none,代表饱和度。在这里,100% 是完全饱和,而 0% 是完全不饱和(灰色)。
  • L
    • : <percentage> 或者关键字 none,代表明度。在这里,100% 是白色,0% 是黑色,50% 是“正常”。
  • A
    • : <alpha-value> 或者关键字 none,其中数字 1 代表 100%(完全不透明)。

[!NOTE] 参见缺失颜色成分 以了解 none 的效果。

形式语法

示例

使用 hsl() 和 conic-gradient()

hsl() 函数和 conic-gradient() 可以很好地配合使用,因为这两个都处理角度。

<div></div>

CSS

div {
  width: 100px;
  height: 100px;
  background: conic-gradient(
    hsl(360 100% 50%),
    hsl(315 100% 50%),
    hsl(270 100% 50%),
    hsl(225 100% 50%),
    hsl(180 100% 50%),
    hsl(135 100% 50%),
    hsl(90 100% 50%),
    hsl(45 100% 50%),
    hsl(0 100% 50%)
  );
  clip-path: circle(closest-side);
}

结果

使用 hsl() 和 conic-gradient()

旧版语法:逗号分隔值

由于历史原因,hsl() 函数接受所有值用逗号分隔的形式。

HTML

<div class="space-separated"></div>
<div class="comma-separated"></div>

CSS

div {
  width: 100px;
  height: 50px;
  margin: 1rem;
}

div.space-separated {
  background-color: hsl(0 100% 50% / 50%);
}

div.comma-separated {
  background-color: hsl(0, 100%, 50%, 50%);
}

结果

旧版语法:逗号分隔值

旧版语法:hsla()

旧版的 hsla() 语法是 hsl() 的别称。

HTML

<div class="hsl"></div>
<div class="hsla"></div>

CSS

div {
  width: 100px;
  height: 50px;
  margin: 1rem;
}

div.hsl {
  background-color: hsl(0 100% 50% / 50%);
}

div.hsla {
  background-color: hsla(0, 100%, 50%, 50%);
}

结果

旧版语法:hsla()

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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