快速参考

属性
grid-cols-1grid-template-columns: repeat(1, minmax(0, 1fr));
grid-cols-2grid-template-columns: repeat(2, minmax(0, 1fr));
grid-cols-3grid-template-columns: repeat(3, minmax(0, 1fr));
grid-cols-4grid-template-columns: repeat(4, minmax(0, 1fr));
grid-cols-5grid-template-columns: repeat(5, minmax(0, 1fr));
grid-cols-6grid-template-columns: repeat(6, minmax(0, 1fr));
grid-cols-7grid-template-columns: repeat(7, minmax(0, 1fr));
grid-cols-8grid-template-columns: repeat(8, minmax(0, 1fr));
grid-cols-9grid-template-columns: repeat(9, minmax(0, 1fr));
grid-cols-10grid-template-columns: repeat(10, minmax(0, 1fr));
grid-cols-11grid-template-columns: repeat(11, minmax(0, 1fr));
grid-cols-12grid-template-columns: repeat(12, minmax(0, 1fr));
grid-cols-nonegrid-template-columns: none;
grid-cols-subgridgrid-template-columns: subgrid;

基本用法

指定网格中的列

使用 grid-cols-{n} 实用程序创建具有 n 个大小相等的列的网格。

01
02
03
04
05
06
07
08
09
<div class="grid grid-cols-4 gap-4">
  <div>01</div>
  <!-- ... -->
  <div>09</div>
</div>

子网格

使用 grid-cols-subgrid 实用程序采用由项目父级定义的列轨道。

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

有条件地应用

悬停、焦点和其他状态

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

<div class="grid grid-cols-1 hover:grid-cols-6">
  <!-- ... -->
</div>

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

断点和媒体查询

您还可以使用变体修饰符来针对媒体查询,例如响应式断点、暗模式、更喜欢减少动作等。例如,使用md:grid-cols-6仅在中等屏幕尺寸及以上应用grid-cols-6实用程序。

<div class="grid grid-cols-1 md:grid-cols-6">
  <!-- ... -->
</div>

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


使用自定义值

自定义您的主题

默认情况下,Tailwind 包含grid-template-column实用程序,用于创建具有最多 12 个相等宽度的列的基本网格。您可以通过编辑tailwind.config.js文件中的theme.gridTemplateColumnstheme.extend.gridTemplateColumns来自定义这些值。

您可以在此处直接访问grid-template-columnsCSS 属性,以便可以根据需要使自定义列值尽可能通用或复杂且特定于站点。

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      gridTemplateColumns: {
        // Simple 16 column grid
        '16': 'repeat(16, minmax(0, 1fr))',

        // Complex site-specific column configuration
        'footer': '200px minmax(900px, 1fr) 100px',
      }
    }
  }
}

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

任意值

如果您需要使用一次性 grid-template-columns 值,而该值不适合包含在您的主题中,请使用方括号使用任意值动态生成一个属性。

<div class="grid grid-cols-[200px_minmax(900px,_1fr)_100px]">
  <!-- ... -->
</div>

任意值文档中了解有关任意值支持的更多信息。