Backgrounds

background-image

用於控制元素背景圖片的通用類別。

ClassStyles
bg-[<value>]
background-image: <value>;
bg-(image:<custom-property>)
background-image: var(<custom-property>);
bg-none
background-image: none;
bg-linear-to-t
background-image: linear-gradient(to top, var(--tw-gradient-stops));
bg-linear-to-tr
background-image: linear-gradient(to top right, var(--tw-gradient-stops));
bg-linear-to-r
background-image: linear-gradient(to right, var(--tw-gradient-stops));
bg-linear-to-br
background-image: linear-gradient(to bottom right, var(--tw-gradient-stops));
bg-linear-to-b
background-image: linear-gradient(to bottom, var(--tw-gradient-stops));
bg-linear-to-bl
background-image: linear-gradient(to bottom left, var(--tw-gradient-stops));
bg-linear-to-l
background-image: linear-gradient(to left, var(--tw-gradient-stops));

範例(Examples)

基本範例(Basic example)

使用 bg-[<value>] 語法來設定元素的背景圖片:

<div class="bg-[url(/img/mountains.jpg)] ..."></div>

新增線性漸層(Adding a linear gradient)

使用 bg-linear-to-rbg-linear-<angle> 等通用類別搭配色彩停駐點通用類別來為元素新增線性漸層:

<div class="h-14 bg-linear-to-r from-cyan-500 to-blue-500"></div><div class="h-14 bg-linear-to-t from-sky-500 to-indigo-500"></div><div class="h-14 bg-linear-to-bl from-violet-500 to-fuchsia-500"></div><div class="h-14 bg-linear-65 from-purple-500 to-pink-500"></div>

新增放射狀漸層(Adding a radial gradient)

使用 bg-radialbg-radial-[<position>] 通用類別搭配色彩停駐點通用類別來為元素新增放射狀漸層:

<div class="size-18 rounded-full bg-radial from-pink-400 from-40% to-fuchsia-700"></div><div class="size-18 rounded-full bg-radial-[at_50%_75%] from-sky-200 via-blue-400 to-indigo-900 to-90%"></div><div class="size-18 rounded-full bg-radial-[at_25%_25%] from-white to-zinc-900 to-75%"></div>

新增錐形漸層(Adding a conic gradient)

使用 bg-conicbg-conic-<angle> 通用類別搭配色彩停駐點通用類別來為元素新增錐形漸層:

<div class="size-24 rounded-full bg-conic from-blue-600 to-sky-400 to-50%"></div><div class="size-24 rounded-full bg-conic-180 from-indigo-600 via-indigo-50 to-indigo-600"></div><div class="size-24 rounded-full bg-conic/decreasing from-violet-700 via-lime-300 to-violet-700"></div>

設定漸層色彩停駐點(Setting gradient color stops)

使用 from-indigo-500via-purple-500to-pink-500 等通用類別來設定漸層停駐點的顏色:

<div class="bg-gradient-to-r from-indigo-500 via-purple-500 to-pink-500 ..."></div>

設定漸層停駐點位置(Setting gradient stop positions)

使用 from-10%via-30%to-90% 等通用類別來設定漸層色彩停駐點的更精確位置:

10%
30%
90%
<div class="bg-gradient-to-r from-indigo-500 from-10% via-sky-500 via-30% to-emerald-500 to-90% ..."></div>

變更內插模式(Changing interpolation mode)

使用內插修飾符來控制漸層的內插模式:

srgb

hsl

oklab

oklch

longer

shorter

increasing

decreasing

<div class="bg-linear-to-r/srgb from-indigo-500 to-teal-400"></div><div class="bg-linear-to-r/hsl from-indigo-500 to-teal-400"></div><div class="bg-linear-to-r/oklab from-indigo-500 to-teal-400"></div><div class="bg-linear-to-r/oklch from-indigo-500 to-teal-400"></div><div class="bg-linear-to-r/longer from-indigo-500 to-teal-400"></div><div class="bg-linear-to-r/shorter from-indigo-500 to-teal-400"></div><div class="bg-linear-to-r/increasing from-indigo-500 to-teal-400"></div><div class="bg-linear-to-r/decreasing from-indigo-500 to-teal-400"></div>

預設情況下,漸層會在 oklab 色彩空間中進行內插。

移除背景圖片(Removing background images)

使用 bg-none 通用類別從元素中移除現有的背景圖片:

<div class="bg-none"></div>

使用自訂值(Using a custom value)

使用 bg-linear-[<value>]from-[<value>] 等通用類別,根據完全自訂的值來設定 gradient

<div class="bg-linear-[25deg,red_5%,yellow_60%,lime_90%,teal] ...">  <!-- ... --></div>

對於 CSS 變數,你也可以使用 bg-linear-(<custom-property>) 語法:

<div class="bg-linear-(--my-gradient) ...">  <!-- ... --></div>

這只是 bg-linear-[var(<custom-property>)] 的簡寫形式,會自動為你加上 var() 函式。

響應式設計(Responsive design)

background-image 通用類別前面加上像 md: 這樣的中斷點變體,讓該通用類別只在中型螢幕尺寸及以上時套用:

<div class="from-purple-400 md:from-yellow-500 ...">  <!-- ... --></div>

變體文件中了解更多關於使用變體的資訊。

自訂你的主題(Customizing your theme)

使用 --color-* 主題變數來自訂專案中的 color 通用類別:

@theme {  --color-regal-blue: #243c5a; }

現在可以在標記中使用 from-regal-bluevia-regal-blueto-regal-blue 等通用類別:

<div class="from-regal-blue">  <!-- ... --></div>

主題文件中了解更多關於自訂主題的資訊。

Copyright © 2026 Tailwind Labs Inc.·商標政策(Brand)