HTML / CSS / 系统课时
扩展自定义颜色
扩展自定义颜色
本课解决品牌色散落在任意值中的问题。你将把品牌色、表面色和状态色声明为 Tailwind 主题变量,再用稳定的工具类应用到按钮、卡片和提示信息中,使浅色与暗色界面共享同一套命名规则。
学习目标
- 能按“品牌层级”和“语义用途”规划颜色令牌。
- 能使用
@theme声明自定义颜色并生成对应工具类。 - 能验证颜色类是否生效,并避免覆盖默认色板或滥用任意值。
规划颜色命名
颜色配置不应只是把十六进制值搬进主题。品牌色适合保留 50、500、600 等强度层级,以便区分浅背景、默认按钮和悬停状态;成功、危险、表面与正文颜色则应按用途命名。这样更换视觉方案时,只需调整令牌,不必逐个搜索组件中的色值。
建议优先使用 brand-500、surface、content、success、danger 这类名称。card-blue、login-red 等名称与具体组件耦合,复用范围小,也会让同一语义在不同页面出现多套颜色。
配置并使用主题颜色
本课采用 Tailwind CSS 4 的 CSS-first 配置方式。下面是现有项目样式入口中的完整片段;@theme 必须位于顶层,它不仅保存 CSS 变量,还会让 Tailwind 生成对应的颜色工具类。
@import "tailwindcss";
@theme {
/* 品牌色保留强度层级,支持默认与交互状态 */
--color-brand-50: #eff6ff;
--color-brand-500: #2563eb;
--color-brand-600: #1d4ed8;
/* 语义色表达用途,不绑定某个具体组件 */
--color-surface: #ffffff;
--color-surface-dark: #0f172a;
--color-content: #0f172a;
--color-content-dark: #e2e8f0;
--color-success: #15803d;
--color-danger: #dc2626;
}变量名位于 --color-* 命名空间后,Tailwind 会生成 bg-brand-500、text-danger、border-success 等工具类。新增名称会扩展默认色板;若重新声明已有变量,例如 --color-blue-500,则会覆盖对应默认值。
在模板中直接使用这些类即可。以下为片段示例,依赖已经启用 Tailwind CSS 与暗色模式的页面环境。
<article class="rounded-2xl bg-surface p-6 text-content shadow-sm dark:bg-surface-dark dark:text-content-dark">
<p class="mb-2 text-success">配置已保存</p>
<h2 class="text-xl font-semibold">品牌主题卡片</h2>
<p class="mt-2 opacity-80">颜色名称描述用途,而不是绑定某个页面。</p>
<!-- 默认色与悬停色来自同一品牌层级 -->
<button class="mt-5 rounded-lg bg-brand-500 px-4 py-2 text-white hover:bg-brand-600">
继续
</button>
</article>预期结果:卡片在浅色模式使用白色表面和深色正文,在暗色模式切换为深色表面和浅色正文;状态文字显示成功色,按钮悬停时从 brand-500 变为 brand-600。
验证与边界处理
启动项目现有的开发命令并打开包含示例的页面,先检查元素是否出现自定义颜色,再在浏览器开发者工具中确认类名对应的 CSS 规则和 --color-* 变量。若类名没有样式,优先检查样式入口是否被应用加载、@theme 是否位于顶层,以及模板中的类名是否为可静态识别的完整字符串。
一次性视觉试验可以使用 bg-[#2563eb],但品牌色或状态色应进入主题。不要为每个组件创建近义令牌,也不要在未评估影响时覆盖整套默认颜色命名空间。仍使用 Tailwind CSS 3 的项目应在 tailwind.config.js 的 theme.extend.colors 中做等价配置,不要与本课的 v4 写法混用。