:root {
--text-color: #190736; /* navy */
body {
--text-color: #333; /* dark gray */
--text-color: #f60; /* orange */
body {
color: var(--text-color);
color: var(--text-color)
在这个例子中,任何包裹在<p>
标签内的文本会是橘黄色。但是<div>
内的文本或是其他元素内的文本仍然是深灰色。
也可以使用style
属性来设置自定义属性的值。比如说,style="--brand-color: #9a09af"
。
自定义属性特别适合管理HSL调色板。HSL代表hue, saturation, lightness 。这是一款基于亮度的颜色模型,类似于RGB。我们可以在CSS中使用HSL,这要归功于hsl()
和hsla()
颜色函数。hsl()
函数接收三个参数,分别是hue, saturation, 和 lightness,也就是色相、饱和度、亮度。hsla()
函数同时接收第四个参数,表示颜色的alpha
透明度(取值范围是0-1之间)。
RGB系统用红、绿、蓝的比例来表达颜色,而HSL则使用一个颜色圈,色相是该圈上的一个度数位置,而色调或阴影则用饱和度和亮度值来定义。饱和度的范围从0%到100%,其中0%是灰色,100%是全色。亮度的范围也是从0%到100%,其中0%是黑色,100%是白色,50%是正常颜色。
在HSL颜色系统中,主要颜色红、绿、蓝三原色在0度/360度、120度和240度处相距120度。二级颜色--青色、品红和黄色--也相距120度,但位于主要颜色的对面,分别为180度、300度和60度/420度。三级、四级和其他颜色则以大约10度的增量介于两者之间。蓝色用HSL来写的话,将会是hsl(240, 100%, 50%)
。
HSL参数单位
当你在hsl()
和hsla()
函数的第一个参数中使用无单位的值时,浏览器会假定它是一个以度为单位的角度。然而,你可以使用任何受支持的CSS角度单位。蓝色也可以表示为hsl(240deg, 100%, 50%)
, hsl(4.188rad, 100%, 50%)
或者 hsla(0.66turn, 100%, 50%)
。
这就是有趣的地方。我们可以使用自定义属性设置色相值,以及通过调整饱和度和亮度来设置更亮和更暗的阴影:
:root {
--brand-hue: 270deg; /* purple */
--brand-hue-alt: .25turn; /* green */
hsl()和hsla()可以接受逗号分隔的参数或空格分隔的参数。
但旧的浏览器(如Internet Explorer 11)只支持逗号分隔的参数。
--brand-primary: hsl( var( --brand-hue ) 100% 50% );
--brand-highlight: hsl( var( --brand-hue ) 100% 75% );
--brand-lowlight: hsl( var( --brand-hue ) 100% 25% );
--brand-inactive: hsl( var( --brand-hue ) 50% 50% );
--brand-secondary: hsl( var( --brand-hue-alt ) 100% 50% );
--brand-2nd-highlight: hsl( var( --brand-hue-alt ) 100% 75% );
--brand-2nd-lowlight: hsl( var( --brand-hue-alt ) 100% 25% );
--brand-2nd-inactive: hsl( var( --brand-hue-alt ) 50% 50% );
上面的CSS提供了下面所示的调色板。
这是一个简易版本,但你也可以使用自定义属性来调整饱和度和亮度值。
健全的调色板生成
另一个想法是结合自定义属性和calc()
函数,从一个基本色调中生成一个方形的配色方案。让我们在下面的例子中创建一个方形配色方案。一个方形配色方案由四种颜色组成,这些颜色在色轮上彼此等距,也就是相距90度:
:root {
--base-hue: 310deg; /* Hot pink */
--distance: 90deg;
--color-a: hsl( var(--base-hue), 100%, 50% );
--color-b: hsl( calc( var(--base-hue) + var( --distance ) ), 100%, 50% );
--color-c: hsl( calc( var(--base-hue) + ( var( --distance ) * 2 ) ), 100%, 50% );
--color-d: hsl( calc( var(--base-hue) + ( var( --distance ) * 3 ) ), 100%, 50% );
CSS为我们提供了如下所示的颇具热带风情的色彩方案。
自定义属性也能很好地与媒体查询相互配合,我们会在后面章节中看到。
深色主题调色板
你可以使用CSS自定义变量为你的网站,定义与深色和浅色主题相关的一系列的变量。
以下面的页面样式为例,我们可以在:root
中为相应的颜色定义了自定义属性后,用变量替换不同选择器中所有的HSL颜色:
:root {
/*...*/
--nav-bg-color: hsl(var(--primarycolor) , 50%, 50%);
--nav-text-color: hsl(var(--primarycolor), 50%, 10%);
--container-bg-color: hsl(var(--primarycolor) , 50%, 95%);
--content-text-color: hsl(var(--primarycolor) , 50%, 50%);
--title-color: hsl(var(--primarycolor) , 50%, 20%);
--footer-bg-color: hsl(var(--primarycolor) , 93%, 88%);
--button-text-color: hsl(var(--primarycolor), 50%, 20%);
已经为自定义属性使用了适当的名称。比如说,--nav-bg-color
指的是导航栏背景色,--nav-text-color
指的是导航栏前景色或者文本色。
然后,复制:root
选择器及其内容,但要为其添加一个带有dark
值的主题属性:
:root[theme='dark']{
/*...*/
如果带有dark
值的主题属性被添加到<html>
元素上,那么该主题将被激活。
现在我们可以手动操作这些变量值,通过减少HSL颜色的亮度值来提供一个深色主题。或者我们可以使用其他技术,如invert()
和brightness()
等CSS过滤器,它们通常用于调整图像的渲染,但也可用于其他任何元素。
添加如下代码到:root[theme='dark']
中:
:root[theme='dark'] {
--dark-hue: 240;
--light-hue: 250;
--primarycolor: var(--dark-hue);
--nav-bg-color: hsl(var(--primarycolor), 50%, 90%);
--nav-text-color: hsl(var(--primarycolor), 50%, 10%);
--container-bg-color: hsl(var(--primarycolor), 50%, 95%);
--content-text-color: hsl(var(--primarycolor), 50%, 50%);
--title-color: hsl(--primarycolor, 50%, 20%);
--footer-bg-color: hsl(var(--primarycolor), 93%, 88%);
--button-text-color: hsl(var(--primarycolor), 50%, 20%);
filter: invert(1) brightness(0.6);
invert()
过滤器会反转所选元素的所有颜色(在本例中是每个元素)。反转的值可以用百分比或数字来指定。参数值100%或1将完全反转元素的色相、饱和度和亮度值。
brightness()
过滤器使元素更加明亮或者暗黑。如果数值为0,就会出现一个完全暗黑的元素。
invert()
过滤器会使一些元素变得非常明亮。需要通过设置brightness(0.6)
来降低亮度。
具有不同程度深色的深色主题:
使用JavaScript切换主题
现在,当用户点击深色/浅色按钮时,我们使用JavaScript来切换深色和浅色主题。在HTML</body>
标签闭合前添加行内<script>
标签,标签内具有如下代码:
const toggleBtn = document.querySelector("#toggle-theme");
toggleBtn.addEventListener('click', e => {
console.log("Switching theme");
if(document.documentElement.hasAttribute('theme')){
document.documentElement.removeAttribute('theme');
else{
document.documentElement.setAttribute('theme', 'dark');
Document.documentElement指的是文档中的根DOM元素,也就是<html>
。这段代码使用.hasAttribute()
方法检查theme
属性是否存在。如果不存在,就将dark
添加到该属性上,从而导致切换到深色主题。否则,它将删除该属性,从而导致切换到浅色主题。
注意:你还应该把它与CSS中的prefers-color-scheme功能结合起来使用,它可以用来从用户的操作系统或用户代理(浏览器)设置中自动改变浅色/深色主题。这将在下一节中展示。
我们还可以在媒体查询中使用自定义属性。比如说,你可以使用自定义属性来定义明暗配色方案:
:root {
--background-primary: hsl(34, 78%, 91%);
--text-primary: hsl(25, 76%, 10%);
--button-primary-bg: hsl(214, 77%, 10%);
--button-primary-fg: hsl(214, 77%, 98%);
@media screen and ( prefers-color-scheme: dark ) {
:root {
--background-primary: hsl(25, 76%, 10%);
--text-primary: hsl(34, 78%, 91%);
--button-primary-bg: hsl(214, 77%, 98%);
--button-primary-fg: hsl(214, 77%, 10%);
同样地,我们可以使用自定义属性来改变适合于屏幕与打印的基准字体大小。
:root {
--base-font-size: 10px;
@media print {
:root {
--base-font-size: 10pt;
html {
font: var(--base-font-size) / 1.5 sans-serif;
body {
font-size: 1.6rem;
在本例中,我们正在使用适合于打印和屏幕的媒体单位。对于这两种媒体,我们将使用10个单位的基准字体大小,对于屏幕来说是像素(px),对于打印来说是点(pt)。我们还将使用--base-font-size:
的值来为我们的根元素(html
)设置一个起始尺寸。然后我们可以rem
单位来调整相对于基准字体尺寸的排版。
在JavaScript中使用自定义属性
请记住:自定义属性是CSS属性,而且我们可以与它们进行互动。比如说,我们可以使用CSS.supports()
API来检测浏览器是否支持自定义属性:
const supportsCustomProps = CSS.supports('--primary-text: #000');
// 如果浏览器支持自定义属性,则打印true
console.log(supportsCustomProps);
我们也可以使用setProperty()
方法来设置自定义属性值:
document.body.style.setProperty('--bg-home', 'whitesmoke');
使用removeProperty()
的方式也是类似的。只需传递自定义属性名称作为参数:
document.body.style.removeProperty('--bg-home');
要使用自定义属性作为JavaScript的值,可以使用var()
函数,并将属性名称作为其参数。
document.body.style.backgroundColor = 'var(--bg-home)';
还有,你不能使用style
对象的方括号语法或驼峰属性来设置自定义属性。换句话说,document.body.style.--bg-home
或document.body.style['--bg-home']
都无法发挥作用。
在组件中使用自定义属性
像React、Angular和Vue这样的JavaScript框架让开发者使用JavaScript来创建可重用、可共享的HTML块,通常会在组件层面上定义CSS。
这是一个有关React组件的示例,使用JSX语法编写:
import React from 'react';
/* Importing the associated CSS into this component */
import '../css/field-button.css';
class FieldButtonGroup extends React.Component {
render() {
return (
<div className="field__button__group">
<label htmlFor={this.props.id}>{this.props.labelText}</label>
<input type={this.props.type}
name={this.props.name}
id={this.props.id}
onChange={this.props.onChangeHandler} />
<button type="submit">{this.props.buttonText}</button>
export default FieldButtonGroup;
我们的React组件将CSS导入到一个JavaScript文件中。编译时,field-button.css
的内容被内联加载。这里有一个可行的方法来使用自定义属性:
.field__button__group label {
display: block;
.field__button__group button {
flex: 0 1 10rem;
background-color: var(--button-bg-color, rgb(103, 58, 183)); /* include a default */
color: #fff;
border: none;
在该示例中,我们使用自定义属性--button-bg-color
作为按钮的背景颜色,同时伴随着默认颜色,以防--button-bg-color
没有定义。在这里,我们可以在全局样式表或通过style
属性设置--button-bg-color
的值。
让我们将值设置为React属性。React props(简称为属性)模仿元素属性。它们是一种将数据传入React组件的方式。在本例中,我们将添加一个名为buttonBgColor
的属性:
import FieldButtonGroup from '../FieldButtonGroup';
class NewsletterSignup extends React.Component {
render() {
// For brevity, we've left out the onChangeHandler prop.
return (
<FieldButtonGroup type="email" name="newsletter" id="newsletter"
labelText="E-mail address" buttonText="Subscribe"
buttonBgColor="rgb(75, 97, 108)" />
export default NewsletterSignup;
现在,我们需要更新FieldButtonGroup
组件,来支持本次更改:
class FieldButtonGroup extends React.Component {
render() {
In React, the style attribute value must be set using a JavaScript
object in which the object keys are CSS properties. Properties
should either be camelCased (e.g. backgroundColor) or enclosed in
quotes.
const buttonStyle = {
'--button-bg-color': this.props.buttonBgColor
return (
<div className="field__button__group">
<label htmlFor={this.props.id}>{this.props.labelText}</label>
<input type={this.props.type}
name={this.props.name} id={this.props.id}
onChange={this.props.onChangeHandler} />
<button type="submit" style={buttonStyle}>
{this.props.buttonText}
</button>
在上述代码中,我们添加了一个buttonStyle
对象,该对象包含自定义属性的名称,并将其值设置为buttonBgColor
属性的值,并为按钮添加style
属性。
使用style
属性可能与你所学到的关于编写CSS的知识相悖。CSS的一个卖点是,我们可以定义一套样式,在多个HTML和XML文档中使用。另一方面,style属性将CSS的范围限制在它所应用的元素上,导致我们不能重用它。并且也不能利用层叠的优势。
但在一个基于组件的前端架构中,一个组件可能在多种情况下被多个团队使用,甚至可能在客户端项目中共享。在这些情况下,你可能想把层叠的全局范围与style
属性所提供的局部范围结合起来。
用style
属性设置自定义属性值,可以将效果限制在FieldButtonGroup
组件这个特定实例中。但是,由于我们使用了一个自定义属性而不是标准的CSS属性,我们仍然可以选择在样式表中定义--button-bg-color
,而不是作为一个组件属性。
自定义属性采用了预处理器的最佳功能之一--变量,并使其成为CSS的原生功能。使用自定义属性,我们可以:
创建可重用的、主题化的组件
轻松调整内边距、外边距以及排版,以适应各种视口尺寸和媒体
改进CSS颜色值的一致性
变量有一系列的应用,在基于组件的设计系统中特别有用。我希望你现在对如何在CSS中使用变量或自定义属性有了更好的理解。
以上就是全部内容,如果对你有所帮助,欢迎点赞收藏转发~