Skip to content

Gradient Color Stops 渐变色停止

控制背景渐变中的颜色停止的实用工具。

ClassPreview

基本用法

起始颜色

使用 from-{color} 实用工具设置渐变的起始颜色。

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

结束颜色

使用 to-{color} 实用工具设置渐变的结束颜色。

html
<div class="bg-gradient-to-r from-cyan-500 to-blue-500 ..."></div>

渐变默认不会从透明中淡入。要从透明中淡入,请反转渐变方向并使用 from-{color} 实用工具。

中间颜色

使用 via-{color} 工具向渐变中添加中间颜色。

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

如果没有 to-{color} ,带有 from-{color}via-{color} 的渐变将默认淡出至透明。

指定停止位置

为了更好地控制渐变颜色的停止位置,请将 from-{position}via-{position}to-{position} 工具与渐变颜色工具结合使用。

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

渐变至透明

渐变默认会淡出至透明,无需显式添加 to-transparent 。Tailwind 会智能计算要使用的“透明”值,以避免 Safari < 15.4 中的一个错误,该错误导致从简单的 transparent 关键字淡出至灰色,看起来非常糟糕。

✘ 不要明确添加 `to-transparent`

html
<div class="bg-gradient-to-r from-blue-500 to-transparent">
	<!-- ... -->
</div>

✓  只需指定一个从颜色自动淡出到透明

html
<div class="bg-gradient-to-r from-blue-500">
	<!-- ... -->
</div>

有条件地应用

悬停、焦点和其他状态

Tailwind 允许您使用变体修饰符在不同状态下有条件地应用实用程序类。例如,使用 hover:from-pink-500 只在悬停时应用 from-pink-500 实用程序。

html
<button type="button" class="bg-gradient-to-r from-green-400 to-blue-500 hover:from-pink-500 hover:to-yellow-500 ...">Hover me</button>

有关所有可用状态修改器的完整列表,请查看悬停、焦点和其他状态文档。

断点和媒体查询

您还可以使用变体修饰符来针对响应式断点、深色模式、prefers-reduced-motion 等媒体查询进行定位。例如,使用 md:from-yellow-500 仅在中等屏幕尺寸及以上应用 from-yellow-500 实用程序。

html
<div class="bg-gradient-to-r from-purple-400 md:from-yellow-500">
	<!-- ... -->
</div>

要了解更多信息,请查看有关响应式设计深色模式其他媒体查询修饰符的文档。

使用自定义值

定制您的主题

默认情况下,Tailwind 包含用于在八个方向创建线性渐变背景的背景图片实用程序。

您可以通过编辑 tailwind.config.js 文件中的 theme.backgroundImage 部分来添加自己的背景图片:

js
module.exports = {
	theme: {
		extend: {
			colors: {

				'regal-blue': '#243c5a', 
			}, 
		},
	},
}

或者,您可以通过编辑 theme.gradientColorStopstheme.extend.gradientColorStops 来自定义您的渐变颜色文件。

除了颜色,您还可以通过编辑 theme.gradientColorStopPositionstheme.extend.gradientColorStopPositions 来自定义渐变颜色停止位置。

js
module.exports = {
	theme: {
		extend: {
			gradientColorStopPositions: {

				33: '33%', 
			}, 
		},
	},
}

有关自定义默认主题的更多信息,请参阅主题自定义文档。

任意值

如果您需要使用一个与主题无关的 from|via|to-{color|position} 值,可以使用方括号来根据任意值动态生成属性。

html
<p class="from-[#243c5a]">
	<!-- ... -->
</p>

有关任意值支持的更多信息,请参阅任意值文档。

Released under the MIT License.