TL;DR

css自定义属性，也常被叫做css变量。带有前缀 -- 的属性名，比如 --example--name，表示的是带有值的自定义属性，其可以通过 var() 函数在全文档范围内复用。

利用自定义属性，可以设计一套颜色方案。基于用户的偏好来切换主题样式。

:root {
  --example--name: value;
}

主题模式

通常为了用户体验，网站主题的最佳实践是提供 1. 系统偏好 2. 亮色 3. 暗色 三种主题模式。

这主要是考量到用户可能

1. 根据系统自动切换主题
2. 根据用户自己的喜好固定主题

cssprefers-color-scheme媒体特性允许根据用户的偏好来设置首选的主题颜色。例如在 windows 11 系统当中。用户可以设置 浅色和深色两种模式。

css可以根据用户系统的主题设置来首选亮色或者暗色主题。

根据语义设计自定义属性

@layer base {
  :root {
    --background: 0 0% 100%;
    --foreground: 240 10% 3.9%;
    --card: 0 0% 100%;
    --card-foreground: 240 10% 3.9%;
    --popover: 0 0% 100%;
    --popover-foreground: 240 10% 3.9%;
    --primary: 240 5.9% 10%;
    --primary-foreground: 0 0% 98%;
    --secondary: 240 4.8% 95.9%;
    --secondary-foreground: 240 5.9% 10%;
    --muted: 240 4.8% 95.9%;
    --muted-foreground: 240 3.8% 46.1%;
    --accent: 240 4.8% 95.9%;
    --accent-foreground: 240 5.9% 10%;
    --destructive: 0 84.2% 60.2%;
    --destructive-foreground: 0 0% 98%;
    --border: 240 5.9% 90%;
    --input: 240 5.9% 90%;
    --ring: 240 5.9% 10%;
    --radius: 0.5rem;
  }

  .dark {
    --background: 240 10% 3.9%;
    --foreground: 0 0% 98%;
    --card: 240 10% 3.9%;
    --card-foreground: 0 0% 98%;
    --popover: 240 10% 3.9%;
    --popover-foreground: 0 0% 98%;
    --primary: 0 0% 98%;
    --primary-foreground: 240 5.9% 10%;
    --secondary: 240 3.7% 15.9%;
    --secondary-foreground: 0 0% 98%;
    --muted: 240 3.7% 15.9%;
    --muted-foreground: 240 5% 64.9%;
    --accent: 240 3.7% 15.9%;
    --accent-foreground: 0 0% 98%;
    --destructive: 0 62.8% 30.6%;
    --destructive-foreground: 0 0% 98%;
    --border: 240 3.7% 15.9%;
    --input: 240 3.7% 15.9%;
    --ring: 240 4.9% 83.9%;
  }
}

/* TODO */

## reference

- [CSS自定义属性](https://developer.mozilla.org/zh-CN/docs/Web/CSS/--*)