色盤
所有附編號的色階、固定色相別名,以及其他預設色彩 token。
本頁目錄
類別
| 類別 | 宣告 |
|---|---|
bg-<name> | background-color: var(--color-<name>); |
fg-<name> | color: var(--color-<name>); |
b-<name> | border-color: var(--color-<name>); |
其他 16 個色彩家族
| 類別 | 宣告 |
|---|---|
bb-<name> | border-bottom-color: var(--color-<name>); |
bl-<name> | border-left-color: var(--color-<name>); |
br-<name> | border-right-color: var(--color-<name>); |
bt-<name> | border-top-color: var(--color-<name>); |
bx-<name> | border-inline-color: var(--color-<name>); |
by-<name> | border-block-color: var(--color-<name>); |
bxe-<name> | border-inline-end-color: var(--color-<name>); |
bxs-<name> | border-inline-start-color: var(--color-<name>); |
bye-<name> | border-block-end-color: var(--color-<name>); |
bys-<name> | border-block-start-color: var(--color-<name>); |
fill-<name> | fill: var(--color-<name>); |
caret-<name> | caret-color: var(--color-<name>); |
accent-<name> | accent-color: var(--color-<name>); |
stroke-<name> | stroke: var(--color-<name>); |
outline-<name> | outline-color: var(--color-<name>); |
text-fill-color-<name> | -webkit-text-fill-color: var(--color-<name>); |
色彩 class 只會設定指定的屬性。要顯示邊框,請同時設定寬度,例如 b(1)、樣式,例如 b-solid,以及色彩,例如 b-blue-60。色彩角色使用相同的家族,並有各自的值對照表。
值
色盤編號是 token 的鍵,不是透明度或明度百分比。編號越大,OKLCH 明度越低。每個色票都可複製 CSS 值或變數參照;下方的色相別名會保留原始 token 參照。
色盤
選擇色票以複製原始 CSS 色彩值。
略過色票色相別名
| 類別 | 值 |
|---|---|
bg-stone | var(--color-stone-30) |
bg-gray | var(--color-gray-30) |
bg-zinc | var(--color-zinc-30) |
bg-neutral | var(--color-neutral-30) |
bg-slate | var(--color-slate-30) |
bg-brown | var(--color-brown-40) |
bg-orange | var(--color-orange-40) |
bg-amber | var(--color-amber-40) |
bg-yellow | var(--color-yellow-40) |
bg-lime | var(--color-lime-40) |
bg-green | var(--color-green-40) |
bg-beryl | var(--color-beryl-40) |
bg-teal | var(--color-teal-40) |
bg-cyan | var(--color-cyan-40) |
bg-sky | var(--color-sky-60) |
bg-blue | var(--color-blue-60) |
bg-indigo | var(--color-indigo-60) |
bg-violet | var(--color-violet-60) |
bg-purple | var(--color-purple-60) |
bg-fuchsia | var(--color-fuchsia-60) |
bg-pink | var(--color-pink-60) |
bg-crimson | var(--color-crimson-60) |
bg-red | var(--color-red-60) |
其他色彩
| 類別 | 值 |
|---|---|
bg-white | oklch(100% 0 none) |
bg-black | oklch(0% 0 none) |
bg-current | currentColor |
色相別名會選取固定色階
bg-blue 讀取 --color-blue,其預設值為 var(--color-blue-60)。bg-yellow 則會取得 --color-yellow-40。使用別名不代表不同色相會對應到相同的色階編號。
色相別名不共用同一個色階編號
預設的 blue 別名參照 blue-60,yellow 則參照 yellow-40。外框用來標示這些參照,不是任一背景 class 加上的邊框。圖中只顯示選取的色階。
文字說明
- bg-blue 讀取 --color-blue,而它在預設集中參照 --color-blue-60。藍色色票列標示出 60 階。
- bg-yellow 讀取 --color-yellow,而它參照 --color-yellow-40。黃色色票列使用相同的一組顯示色階,並標示出 40 階。
- 兩列都使用 10、20、40、60、80 與 90 階的實際色盤色彩。色票採等寬是為了比較,不是呈現感知距離的尺度。
- 這兩條別名參照鏈在淺色與深色配色方案中維持相同。重新定義別名或它參照的 token,就可能改變結果。
附編號的色階與色相別名不會隨配色方案切換。fg-text-blue 這類自適應文字別名屬於色彩角色。重新定義 token 可以改變其中任一種行為。
bg-current 讀取 currentColor,因此結果會跟隨元素的文字色彩。預設集沒有 --color-transparent token。需要透明色或其他字面色彩值時,請使用原生宣告,例如 (background-color:transparent) 或 (background-color:#175fe9)。
用法
這些狀態標籤明確指定了前景與背景色階。即使沒有色彩,文字仍能傳達狀態,而且所選色彩在兩種配色方案中都維持不變。
<div> <span class="… bg-green-5 fg-green-80">Paid</span> <span class="… bg-amber-5 fg-amber-80">Pending</span> <span class="… bg-red-5 fg-red-80">Overdue</span> <span class="… bg-blue-5 fg-blue-70">Draft</span></div>產生的 CSS
@layer theme { :root, :host { --color-amber-5: oklch(96.24% .0573 98.1); --color-amber-80: oklch(53.09% .1677 39.7); --color-green-5: oklch(94.95% .071 145.5); --color-green-80: oklch(51.96% .1768 142.5); --color-blue-5: oklch(93.53% .0305 231.3); --color-blue-70: oklch(46.26% .3057 266.7); --color-red-5: oklch(94.05% .0239 17); --color-red-80: oklch(53.09% .2178 29.2) }}@layer utilities { .bg-amber-5 { background-color: var(--color-amber-5) } .bg-blue-5 { background-color: var(--color-blue-5) } .bg-green-5 { background-color: var(--color-green-5) } .bg-red-5 { background-color: var(--color-red-5) } .fg-amber-80 { color: var(--color-amber-80) } .fg-blue-70 { color: var(--color-blue-70) } .fg-green-80 { color: var(--color-green-80) } .fg-red-80 { color: var(--color-red-80) }}自訂
在 @theme 中註冊色彩後,色彩家族就能使用它的鍵。這裡的 brand 可用於 bg-brand、fg-brand、b-brand 等 class。
@theme { --color-brand: oklch(56% .2 262);}產生的 CSS
@layer theme { :root, :host { --color-brand: oklch(56% .2 262) }}@layer utilities { .bg-brand { background-color: var(--color-brand) }}
