Skip to content
全部文档

background-position

用于控制元素背景图片位置的工具类。

快速参考

属性
bg-top-leftbackground-position: top left;
bg-topbackground-position: top;
bg-top-rightbackground-position: top right;
bg-leftbackground-position: left;
bg-centerbackground-position: center;
bg-rightbackground-position: right;
bg-bottom-leftbackground-position: bottom left;
bg-bottombackground-position: bottom;
bg-bottom-rightbackground-position: bottom right;
bg-position-(<custom-property>)background-position: var(<custom-property>);
bg-position-[<value>]background-position: <value>;

示例

基础示例

使用 bg-centerbg-rightbg-top-left 等工具类控制元素背景图片的位置:

bg-top-left

bg-top

bg-top-right

bg-left

bg-center

bg-right

bg-bottom-left

bg-bottom

bg-bottom-right

html
<!-- [!code classes:bg-top-left,bg-top-right,bg-bottom-right,bg-bottom-left,bg-center,bg-right,bg-top,bg-bottom,bg-left] -->
<div class="bg-[url(/img/mountains.jpg)] bg-top-left"></div>
<div class="bg-[url(/img/mountains.jpg)] bg-top"></div>
<div class="bg-[url(/img/mountains.jpg)] bg-top-right"></div>
<div class="bg-[url(/img/mountains.jpg)] bg-left"></div>
<div class="bg-[url(/img/mountains.jpg)] bg-center"></div>
<div class="bg-[url(/img/mountains.jpg)] bg-right"></div>
<div class="bg-[url(/img/mountains.jpg)] bg-bottom-left"></div>
<div class="bg-[url(/img/mountains.jpg)] bg-bottom"></div>
<div class="bg-[url(/img/mountains.jpg)] bg-bottom-right"></div>

使用自定义值

使用 bg-position-[<value>] 等工具类,根据完全自定义的值设置背景位置:

html
<div class="bg-position-[center_top_1rem] ...">
 <!-- ... -->
</div>

对于 CSS 变量,也可以使用 bg-position-(<custom-property>) 语法:

html
<div class="bg-position-(--my-bg-position) ...">
 <!-- ... -->
</div>

这只是 bg-position-[var(<custom-property>)] 的简写,会自动为你加上 var() 函数。

响应式设计

使用 md: 等断点变体作为 background-position 工具类的前缀,即可只在中等屏幕尺寸及以上应用该工具类:

html
<div class="bg-center md:bg-top ...">
 <!-- ... -->
</div>

更多关于变体的用法,请参阅变体文档

文档译文以 MIT 协议授权;原文版权归 Tailwind Labs。湘ICP备2026005453号-2