1. 核心概念
  2. 颜色

核心概念

Colors

在 Tailwind CSS 项目中使用和自定义调色板。

Tailwind CSS 内置了一个由专业设计师精心打造的、丰富而美观的调色板,适用于各种不同的设计风格。

 
50
100
200
300
400
500
600
700
800
900
950

red

orange

amber

yellow

lime

green

emerald

teal

cyan

sky

blue

indigo

violet

purple

fuchsia

pink

rose

slate

gray

zinc

neutral

stone

Click to copy the OKLCH value or shift+click to copy the nearest hex value.

默认调色板中的每种颜色都包含 11 个色阶,其中 50 是最浅的,950 是最深的:

50

100

200

300

400

500

600

700

800

900

950

<div>  <div class="bg-sky-50"></div>  <div class="bg-sky-100"></div>  <div class="bg-sky-200"></div>  <div class="bg-sky-300"></div>  <div class="bg-sky-400"></div>  <div class="bg-sky-500"></div>  <div class="bg-sky-600"></div>  <div class="bg-sky-700"></div>  <div class="bg-sky-800"></div>  <div class="bg-sky-900"></div>  <div class="bg-sky-950"></div></div>

整个调色板可用于所有与颜色相关的工具类,包括背景颜色边框颜色填充光标颜色等等。

颜色处理

使用颜色工具类

使用诸如 bg-whiteborder-pink-300text-gray-950 这样的颜色工具类来设置设计中元素的不同颜色属性:

Tom Watson Logo redesign 中提到了你

上午 9:37

<div class="flex items-center gap-4 rounded-lg bg-white p-6 shadow-md outline outline-black/5 dark:bg-gray-800">  <span class="inline-flex shrink-0 rounded-full border border-pink-300 bg-pink-100 p-2 dark:border-pink-300/10 dark:bg-pink-400/10">    <svg class="size-6 stroke-pink-700 dark:stroke-pink-500"><!-- ... --></svg>  </span>  <div>    <p class="text-gray-700 dark:text-gray-400">      <span class="font-medium text-gray-950 dark:text-white">Tom Watson</span>      <span class="font-medium text-gray-950 dark:text-white">Logo redesign</span> 中提到了你    </p>    <time class="mt-1 block text-gray-500" datetime="9:37">上午 9:37</time>  </div></div>

以下是使用您调色板的完整工具类列表:

工具类描述
bg-*设置元素的背景颜色
text-*设置元素的文本颜色
decoration-*设置元素的文本装饰颜色
border-*设置元素的边框颜色
outline-*设置元素的轮廓颜色
shadow-*设置盒阴影的颜色
inset-shadow-*设置内嵌盒阴影的颜色
ring-*设置环形阴影的颜色
inset-ring-*设置内嵌环形阴影的颜色
accent-*设置表单控件的强调色
caret-*设置表单控件中的光标颜色
fill-*设置 SVG 元素的填充颜色
stroke-*设置 SVG 元素的描边颜色

调整透明度

您可以使用类似 bg-black/75 的语法来调整颜色的透明度,其中 75 将颜色的 alpha 通道设置为 75%:

<div>  <div class="bg-sky-500/10"></div>  <div class="bg-sky-500/20"></div>  <div class="bg-sky-500/30"></div>  <div class="bg-sky-500/40"></div>  <div class="bg-sky-500/50"></div>  <div class="bg-sky-500/60"></div>  <div class="bg-sky-500/70"></div>  <div class="bg-sky-500/80"></div>  <div class="bg-sky-500/90"></div>  <div class="bg-sky-500/100"></div></div>

此语法还支持任意值和 CSS 变量简写:

HTML
<div class="bg-pink-500/[71.37%]"><!-- ... --></div><div class="bg-cyan-400/(--my-alpha-value)"><!-- ... --></div>

暗黑模式目标定位

使用 dark 变体来编写类似 dark:bg-gray-800 的类,这些样式仅在暗黑模式激活时应用:

浅色模式

倒立书写

零重力笔可以在任何方向书写,包括倒立。它甚至在外太空也能使用。

暗黑模式

倒立书写

零重力笔可以在任何方向书写,包括倒立。它甚至在外太空也能使用。

<div class="bg-white dark:bg-gray-800 rounded-lg px-6 py-8 ring shadow-xl ring-gray-900/5">  <div>    <span class="inline-flex items-center justify-center rounded-md bg-indigo-500 p-2 shadow-lg">      <svg class="h-6 w-6 stroke-white" ...>        <!-- ... -->      </svg>    </span>  </div>  <h3 class="text-gray-900 dark:text-white mt-5 text-base font-medium tracking-tight ">倒立书写</h3>  <p class="text-gray-500 dark:text-gray-400 mt-2 text-sm ">    零重力笔可以在任何方向书写,包括倒立。它甚至在外太空也能使用。  </p></div>

了解更多关于暗黑模式样式的内容,请参阅暗黑模式文档

在 CSS 中引用颜色

颜色以 CSS 变量的形式暴露在 --color-* 命名空间下,因此你可以通过 --color-blue-500--color-pink-700 这样的变量在 CSS 中引用它们:

CSS
@import "tailwindcss";@layer components {  .typography {    color: var(--color-gray-950);    a {      color: var(--color-blue-500);      &:hover {        color: var(--color-blue-800);      }    }  }}

你也可以在工具类中使用这些变量作为任意值

HTML
<div class="bg-[light-dark(var(--color-white),var(--color-gray-950))]">  <!-- ... --></div>

为了在 CSS 中引用颜色变量时快速调整透明度,Tailwind 提供了一个特殊的 --alpha() 函数:

CSS
@import "tailwindcss";@layer components {  .DocSearch-Hit--Result {    background-color: --alpha(var(--color-gray-950) / 10%);  }}

自定义颜色

使用 @theme 将自定义颜色添加到项目的 --color-* 主题命名空间下:

CSS
@import "tailwindcss";@theme {  --color-midnight: #121063;  --color-tahiti: #3ab7bf;  --color-bermuda: #78dcca;}

现在除了默认颜色外,你的项目中还会提供 bg-midnighttext-tahitifill-bermuda 等工具类。

主题变量文档中了解更多关于主题变量的信息。

覆盖默认颜色

通过定义同名的新主题变量来覆盖任何默认颜色:

CSS
@import "tailwindcss";@theme {  --color-gray-50: oklch(0.984 0.003 247.858);  --color-gray-100: oklch(0.968 0.007 247.896);  --color-gray-200: oklch(0.929 0.013 255.508);  --color-gray-300: oklch(0.869 0.022 252.894);  --color-gray-400: oklch(0.704 0.04 256.788);  --color-gray-500: oklch(0.554 0.046 257.417);  --color-gray-600: oklch(0.446 0.043 257.281);  --color-gray-700: oklch(0.372 0.044 257.287);  --color-gray-800: oklch(0.279 0.041 260.031);  --color-gray-900: oklch(0.208 0.042 265.755);  --color-gray-950: oklch(0.129 0.042 264.695);}

禁用默认颜色

通过将颜色的主题命名空间设置为 initial 来禁用任何默认颜色:

CSS
@import "tailwindcss";@theme {  --color-lime-*: initial;  --color-fuchsia-*: initial;}

这对于从输出中移除你不打算使用的颜色对应的 CSS 变量特别有用。

使用自定义调色板

使用 --color-*: initial 完全禁用所有默认颜色并定义你自己的自定义调色板:

CSS
@import "tailwindcss";@theme {  --color-*: initial;  --color-white: #fff;  --color-purple: #3f3cbb;  --color-midnight: #121063;  --color-tahiti: #3ab7bf;  --color-bermuda: #78dcca;}

引用其他变量

在定义引用其他颜色的颜色时,使用 @theme inline

CSS
@import "tailwindcss";:root {  --acme-canvas-color: oklch(0.967 0.003 264.542);}[data-theme="dark"] {  --acme-canvas-color: oklch(0.21 0.034 264.665);}@theme inline {  --color-canvas: var(--acme-canvas-color);}

在主题文档中了解更多关于引用其他变量的信息。

默认调色板参考

以下是默认颜色及其对应值的完整列表,供参考:

CSS
@theme {  --color-red-50: oklch(0.971 0.013 17.38);  --color-red-100: oklch(0.936 0.032 17.717);  --color-red-200: oklch(0.885 0.062 18.334);  --color-red-300: oklch(0.808 0.114 19.571);  --color-red-400: oklch(0.704 0.191 22.216);  --color-red-500: oklch(0.637 0.237 25.331);  --color-red-600: oklch(0.577 0.245 27.325);  --color-red-700: oklch(0.505 0.213 27.518);  --color-red-800: oklch(0.444 0.177 26.899);  --color-red-900: oklch(0.396 0.141 25.723);  --color-red-950: oklch(0.258 0.092 26.042);  --color-orange-50: oklch(0.98 0.016 73.684);  --color-orange-100: oklch(0.954 0.038 75.164);  --color-orange-200: oklch(0.901 0.076 70.697);  --color-orange-300: oklch(0.837 0.128 66.29);  --color-orange-400: oklch(0.75 0.183 55.934);  --color-orange-500: oklch(0.705 0.213 47.604);  --color-orange-600: oklch(0.646 0.222 41.116);  --color-orange-700: oklch(0.553 0.195 38.402);  --color-orange-800: oklch(0.47 0.157 37.304);  --color-orange-900: oklch(0.408 0.123 38.172);  --color-orange-950: oklch(0.266 0.079 36.259);  --color-amber-50: oklch(0.987 0.022 95.277);  --color-amber-100: oklch(0.962 0.059 95.617);  --color-amber-200: oklch(0.924 0.12 95.746);  --color-amber-300: oklch(0.879 0.169 91.605);  --color-amber-400: oklch(0.828 0.189 84.429);  --color-amber-500: oklch(0.769 0.188 70.08);  --color-amber-600: oklch(0.666 0.179 58.318);  --color-amber-700: oklch(0.555 0.163 48.998);  --color-amber-800: oklch(0.473 0.137 46.201);  --color-amber-900: oklch(0.414 0.112 45.904);  --color-amber-950: oklch(0.279 0.077 45.635);  --color-yellow-50: oklch(0.987 0.026 102.212);  --color-yellow-100: oklch(0.973 0.071 103.193);  --color-yellow-200: oklch(0.945 0.129 101.54);  --color-yellow-300: oklch(0.905 0.182 98.111);  --color-yellow-400: oklch(0.852 0.199 91.936);  --color-yellow-500: oklch(0.795 0.184 86.047);  --color-yellow-600: oklch(0.681 0.162 75.834);  --color-yellow-700: oklch(0.554 0.135 66.442);  --color-yellow-800: oklch(0.476 0.114 61.907);  --color-yellow-900: oklch(0.421 0.095 57.708);  --color-yellow-950: oklch(0.286 0.066 53.813);  --color-lime-50: oklch(0.986 0.031 120.757);  --color-lime-100: oklch(0.967 0.067 122.328);  --color-lime-200: oklch(0.938 0.127 124.321);  --color-lime-300: oklch(0.897 0.196 126.665);  --color-lime-400: oklch(0.841 0.238 128.85);  --color-lime-500: oklch(0.768 0.233 130.85);  --color-lime-600: oklch(0.648 0.2 131.684);  --color-lime-700: oklch(0.532 0.157 131.589);  --color-lime-800: oklch(0.453 0.124 130.933);  --color-lime-900: oklch(0.405 0.101 131.063);  --color-lime-950: oklch(0.274 0.072 132.109);  --color-green-50: oklch(0.982 0.018 155.826);  --color-green-100: oklch(0.962 0.044 156.743);  --color-green-200: oklch(0.925 0.084 155.995);  --color-green-300: oklch(0.871 0.15 154.449);  --color-green-400: oklch(0.792 0.209 151.711);  --color-green-500: oklch(0.723 0.219 149.579);  --color-green-600: oklch(0.627 0.194 149.214);  --color-green-700: oklch(0.527 0.154 150.069);  --color-green-800: oklch(0.448 0.119 151.328);  --color-green-900: oklch(0.393 0.095 152.535);  --color-green-950: oklch(0.266 0.065 152.934);  --color-emerald-50: oklch(0.979 0.021 166.113);  --color-emerald-100: oklch(0.95 0.052 163.051);  --color-emerald-200: oklch(0.905 0.093 164.15);  --color-emerald-300: oklch(0.845 0.143 164.978);  --color-emerald-400: oklch(0.765 0.177 163.223);  --color-emerald-500: oklch(0.696 0.17 162.48);  --color-emerald-600: oklch(0.596 0.145 163.225);  --color-emerald-700: oklch(0.508 0.118 165.612);  --color-emerald-800: oklch(0.432 0.095 166.913);  --color-emerald-900: oklch(0.378 0.077 168.94);  --color-emerald-950: oklch(0.262 0.051 172.552);  --color-teal-50: oklch(0.984 0.014 180.72);  --color-teal-100: oklch(0.953 0.051 180.801);  --color-teal-200: oklch(0.91 0.096 180.426);  --color-teal-300: oklch(0.855 0.138 181.071);  --color-teal-400: oklch(0.777 0.152 181.912);  --color-teal-500: oklch(0.704 0.14 182.503);  --color-teal-600: oklch(0.6 0.118 184.704);  --color-teal-700: oklch(0.511 0.096 186.391);  --color-teal-800: oklch(0.437 0.078 188.216);  --color-teal-900: oklch(0.386 0.063 188.416);  --color-teal-950: oklch(0.277 0.046 192.524);  --color-cyan-50: oklch(0.984 0.019 200.873);  --color-cyan-100: oklch(0.956 0.045 203.388);  --color-cyan-200: oklch(0.917 0.08 205.041);  --color-cyan-300: oklch(0.865 0.127 207.078);  --color-cyan-400: oklch(0.789 0.154 211.53);  --color-cyan-500: oklch(0.715 0.143 215.221);  --color-cyan-600: oklch(0.609 0.126 221.723);  --color-cyan-700: oklch(0.52 0.105 223.128);  --color-cyan-800: oklch(0.45 0.085 224.283);  --color-cyan-900: oklch(0.398 0.07 227.392);  --color-cyan-950: oklch(0.302 0.056 229.695);  --color-sky-50: oklch(0.977 0.013 236.62);  --color-sky-100: oklch(0.951 0.026 236.824);  --color-sky-200: oklch(0.901 0.058 230.902);  --color-sky-300: oklch(0.828 0.111 230.318);  --color-sky-400: oklch(0.746 0.16 232.661);  --color-sky-500: oklch(0.685 0.169 237.323);  --color-sky-600: oklch(0.588 0.158 241.966);  --color-sky-700: oklch(0.5 0.134 242.749);  --color-s sky-800: oklch(0.443 0.11 240.79);  --color-sky-900: oklch(0.391 0.09 240.876);  --color-sky-950: oklch(0.293 0.066 243.157);  --color-blue-50: oklch(0.97 0.014 254.604);  --color-blue-100: oklch(0.932 0.032 255.585);  --color-blue-200: oklch(0.882 0.059 254.128);  --color-blue-300: oklch(0.809 0.105 251.813);  --color-blue-400: oklch(0.707 0.165 254.624);  --color-blue-500: oklch(0.623 0.214 259.815);  --color-blue-600: oklch(0.546 0.245 262.881);  --color-blue-700: oklch(0.488 0.243 264.376);  --color-blue-800: oklch(0.424 0.199 265.638);  --color-blue-900: oklch(0.379 0.146 265.522);  --color-blue-950: oklch(0.282 0.091 267.935);  --color-indigo-50: oklch(0.962 0.018 272.314);  --color-indigo-100: oklch(0.93 0.034 272.788);  --color-indigo-200: oklch(0.87 0.065 274.039);  --color-indigo-300: oklch(0.785 0.115 274.713);  --color-indigo-400: oklch(0.673 0.182 276.935);  --color-indigo-500: oklch(0.585 0.233 277.117);  --color-indigo-600: oklch(0.511 0.262 276.966);  --color-indigo-700: oklch(0.457 0.24 277.023);  --color-indigo-800: oklch(0.398 0.195 277.366);  --color-indigo-900: oklch(0.359 0.144 278.697);  --color-indigo-950: oklch(0.257 0.09 281.288);  --color-violet-50: oklch(0.969 0.016 293.756);  --color-violet-100: oklch(0.943 0.029 294.588);  --color-violet-200: oklch(0.894 0.057 293.283);  --color-violet-300: oklch(0.811 0.111 293.571);  --color-violet-400: oklch(0.702 0.183 293.541);  --color-violet-500: oklch(0.606 0.25 292.717);  --color-violet-600: oklch(0.541 0.281 293.009);  --color-violet-700: oklch(0.491 0.27 292.581);  --color-violet-800: oklch(0.432 0.232 292.759);  --color-violet-900: oklch(0.38 0.189 293.745);  --color-violet-950: oklch(0.283 0.141 291.089);  --color-purple-50: oklch(0.977 0.014 308.299);  --color-purple-100: oklch(0.946 0.033 307.174);  --color-purple-200: oklch(0.902 0.063 306.703);  --color-purple-300: oklch(0.827 0.119 306.383);  --color-purple-400: oklch(0.714 0.203 305.504);  --color-purple-500: oklch(0.627 0.265 303.9);  --color-purple-600: oklch(0.558 0.288 302.321);  --color-purple-700: oklch(0.496 0.265 301.924);  --color-purple-800: oklch(0.438 0.218 303.724);  --color-purple-900: oklch(0.381 0.176 304.987);  --color-purple-950: oklch(0.291 0.149 302.717);  --color-fuchsia-50: oklch(0.977 0.017 320.058);  --color-fuchsia-100: oklch(0.952 0.037 318.852);  --color-fuchsia-200: oklch(0.903 0.076 319.62);  --color-fuchsia-300: oklch(0.833 0.145 321.434);  --color-fuchsia-400: oklch(0.74 0.238 322.16);  --color-fuchsia-500: oklch(0.667 0.295 322.15);  --color-fuchsia-600: oklch(0.591 0.293 322.896);  --color-fuchsia-700: oklch(0.518 0.253 323.949);  --color-fuchsia-800: oklch(0.452 0.211 324.591);  --color-fuchsia-900: oklch(0.401 0.17 325.612);  --color-fuchsia-950: oklch(0.293 0.136 325.661);  --color-pink-50: oklch(0.971 0.014 343.198);  --color-pink-100: oklch(0.948 0.028 342.258);  --color-pink-200: oklch(0.899 0.061 343.231);  --color-pink-300: oklch(0.823 0.12 346.018);  --color-pink-400: oklch(0.718 0.202 349.761);  --color-p
Copyright © 2025 Tailwind Labs Inc.·Trademark Policy