Skip to content
全部文档

gap

用于控制网格和 flexbox 项目之间间距的工具类。

快速参考

属性
gap-<number>gap: calc(var(--spacing) * <value>);
gap-pxgap: 1px;
gap-(<custom-property>)gap: var(<custom-property>);
gap-[<value>]gap: <value>;
gap-x-<number>column-gap: calc(var(--spacing) * <value>);
gap-x-pxcolumn-gap: 1px;
gap-x-(<custom-property>)column-gap: var(<custom-property>);
gap-x-[<value>]column-gap: <value>;
gap-y-<number>row-gap: calc(var(--spacing) * <value>);
gap-y-pxrow-gap: 1px;
gap-y-(<custom-property>)row-gap: var(<custom-property>);
gap-y-[<value>]row-gap: <value>;

示例

基础示例

使用 gap-2gap-4gap-<number> 工具类,更改网格和 flexbox 布局中行与列之间的间距:

01
02
03
04
html
<!-- [!code classes:gap-4] -->
<div class="grid grid-cols-2 gap-4">
  <div>01</div>
  <div>02</div>
  <div>03</div>
  <div>04</div>
</div>

分别更改行间距和列间距

使用 gap-x-8gap-y-4gap-x-<number>gap-y-<number> 工具类,分别更改列间距和行间距:

01
02
03
04
05
06
html
<!-- [!code classes:gap-x-8,gap-y-4] -->
<div class="grid grid-cols-3 gap-x-8 gap-y-4">
  <div>01</div>
  <div>02</div>
  <div>03</div>
  <div>04</div>
  <div>05</div>
  <div>06</div>
</div>

使用自定义值

使用 gap-[<value>]gap-x-[<value>]gap-y-[<value>] 等工具类,按完全自定义的值设置间距:

html
<div class="gap-[10vw] ...">
 <!-- ... -->
</div>

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

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

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

响应式设计

使用 md: 等断点变体作为 gapcolumn-gaprow-gap 工具类的前缀,即可只在中等屏幕尺寸及以上生效:

html
<div class="grid gap-4 md:gap-6 ...">
 <!-- ... -->
</div>

变体文档中了解有关使用变体的更多信息。

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