Skip to content

Grid Column Start / End 网格列开始/结束

用于控制元素在网格列中的大小和位置的实用工具。

ClassProperties

基本用法

跨列

使用 col-span-{n} 实用工具使元素跨越 n 列。

01
02
03
04
05
06
07
html
<div class="grid grid-cols-3 gap-4">
  <div class="...">01</div>
  <div class="...">02</div>
  <div class="...">03</div>
  <div class="col-span-2 ...">04</div>
  <div class="...">05</div>
  <div class="...">06</div>
  <div class="col-span-2 ...">07</div>
</div>

起始和结束线

使用 col-start-{n}col-end-{n} 实用程序使元素在第 n 个网格线上开始或结束。这些还可以与 col-span-{n} 实用程序结合,以跨越特定数量的列。

请注意,CSS 网格线从 1 开始,而不是从 0 开始,因此在 6 列网格中,全宽元素将从第 1 行开始,到第 7 行结束。

01
02
03
04
html
<div class="grid grid-cols-6 gap-4">
  <div class="col-start-2 col-span-4 ...">01</div>
  <div class="col-start-1 col-end-3 ...">02</div>
  <div class="col-end-7 col-span-2 ...">03</div>
  <div class="col-start-1 col-end-7 ...">04</div>
</div>

有条件地应用

悬停,焦点和其他状态

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

html
<div class="col-span-2 hover:col-span-6">
  <!-- ... -->
</div>

要查看所有可用状态修饰符的完整列表,请查看悬停,焦点和其他状态文档。

断点和媒体查询

您还可以使用变体修饰符来定位媒体查询,如响应式断点、暗模式、偏好减少动作等。例如,使用 md:col-span-6 仅在中等屏幕尺寸及以上应用 col-span-6 实用程序。

html
<div class="col-span-2 md:col-span-6">
  <!-- ... -->
</div>

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

使用自定义值

自定义您的主题

默认情况下,Tailwind 包括用于处理最多 12 列网格的 grid-column 实用程序。您可以通过自定义 Tailwind 主题配置的 gridColumngridColumnStartgridColumnEnd 部分来更改、添加或删除这些内容。

要创建更多直接控制 grid-column 简写属性的 col-{value} 实用程序,请自定义 Tailwind 主题配置的 gridColumn 部分:

js
module.exports = {
  theme: {
    extend: {
      gridColumn: {							
        'span-16': 'span 16 / span 16',		
      }										
    }
  }
}

我们在内部使用这个来处理我们的 col-span-{n} 实用程序。请注意,由于这会直接配置 grid-column 简写属性,因此我们在值名称中直接包含了单词 span ,它不会自动嵌入到类名中。这意味着您可以自由添加任何您想要的条目 — 它们不仅仅是 span 实用程序。

要添加新的 col-start-{n} 实用程序,请使用您的 Tailwind 主题配置的 gridColumnStart 部分:

js
module.exports = {
  theme: {
    extend: {
      gridColumnStart: {	
        '13': '13',			
        '14': '14',			
        '15': '15',			
        '16': '16',			
        '17': '17',			
      }						
    }
  }
}

要添加新的 col-end-{n} 实用程序,请使用您的 Tailwind 主题配置的 gridColumnEnd 部分:

js
module.exports = {
  theme: {
    extend: {
      gridColumnEnd: {		
        '13': '13',			
        '14': '14',			
        '15': '15',			
        '16': '16',			
        '17': '17',			
      }						
    }
  }
}

了解有关在主题自定义文档中自定义默认主题的更多信息。

任意值

如果您需要使用一次性 grid-column/grid-column-start/grid-column-end 值,而这个值在您的主题中没有意义,可以使用方括号来使用任意值动态生成属性。

html
<div class="col-[16_/_span_16]">
  <!-- ... -->
</div>

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

Released under the MIT License.