快速参考

属性
row-autogrid-row: auto;
row-span-1grid-row: span 1 / span 1;
row-span-2grid-row: span 2 / span 2;
row-span-3grid-row: span 3 / span 3;
row-span-4grid-row: span 4 / span 4;
row-span-5grid-row: span 5 / span 5;
row-span-6grid-row: span 6 / span 6;
row-span-7grid-row: span 7 / span 7;
row-span-8grid-row: span 8 / span 8;
row-span-9grid-row: span 9 / span 9;
row-span-10grid-row: span 10 / span 10;
row-span-11grid-row: span 11 / span 11;
row-span-12grid-row: span 12 / span 12;
row-span-fullgrid-row: 1 / -1;
row-start-1grid-row-start: 1;
row-start-2grid-row-start: 2;
row-start-3grid-row-start: 3;
row-start-4grid-row-start: 4;
row-start-5grid-row-start: 5;
row-start-6grid-row-start: 6;
row-start-7grid-row-start: 7;
row-start-8grid-row-start: 8;
row-start-9grid-row-start: 9;
row-start-10grid-row-start: 10;
row-start-11grid-row-start: 11;
row-start-12grid-row-start: 12;
row-start-13grid-row-start: 13;
row-start-autogrid-row-start: auto;
row-end-1grid-row-end: 1;
row-end-2grid-row-end: 2;
行尾-3grid-row-end: 3;
行尾-4grid-row-end: 4;
行尾-5grid-row-end: 5;
行尾-6grid-row-end: 6;
行尾-7grid-row-end: 7;
行尾-8grid-row-end: 8;
行尾-9grid-row-end: 9;
行尾-10grid-row-end: 10;
行尾-11grid-row-end: 11;
行尾-12grid-row-end: 12;
行尾-13grid-row-end: 13;
行尾-自动grid-row-end: auto;

基本用法

跨行

使用 row-span-{n} 实用程序使元素跨越 n 行。

01
02
03
<div class="grid grid-rows-3 grid-flow-col gap-4">
  <div class="row-span-3 ...">01</div>
  <div class="col-span-2 ...">02</div>
  <div class="row-span-2 col-span-2 ...">03</div>
</div>

起始行和结束行

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

请注意,CSS 网格行从 1 开始,而不是 0,因此 3 行网格中的全高元素将从第 1 行开始,在第 4 行结束。

01
02
03
<div class="grid grid-rows-3 grid-flow-col gap-4">
  <div class="row-start-2 row-span-2 ...">01</div>
  <div class="row-end-3 row-span-2 ...">02</div>
  <div class="row-start-1 row-end-4 ...">03</div>
</div>

有条件地应用

悬停、焦点和其他状态

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

<div class="row-span-3 hover:row-span-4">
  <!-- ... -->
</div>

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

断点和媒体查询

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

<div class="row-span-3 md:row-span-4">
  <!-- ... -->
</div>

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


使用自定义值

自定义你的主题

默认情况下,Tailwind 包含 grid-row 实用程序,用于处理最多有 6 个显式行的网格。你可以通过编辑 `tailwind.config.js` 文件中的 `theme.gridRow`、`theme.extend.gridRow`、`theme.gridRowStart`、`theme.extend.gridRowStart`、`theme.gridRowEnd` 和 `theme.extend.gridRowEnd` 来自定义这些值。

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

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

我们在内部将此用于我们的 `row-span-{n}` 实用程序。请注意,由于这直接配置了 `grid-row` 简写属性,因此我们在值名称中直接包含单词 `span`,它不会自动烘焙到类名中。这意味着你可以自由地在此处添加执行任何操作的条目——它们不只是 `span` 实用程序。

要添加新的 `row-start-{n}` 实用程序,请使用 Tailwind 主题配置的 `gridRowStart` 部分

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      gridRowStart: {
        '8': '8',
        '9': '9',
        '10': '10',
        '11': '11',
        '12': '12',
        '13': '13',
      }
    }
  }
}

要添加新的 `row-end-{n}` 实用程序,请使用 Tailwind 主题配置的 `gridRowEnd` 部分

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      gridRowEnd: {
        '8': '8',
        '9': '9',
        '10': '10',
        '11': '11',
        '12': '12',
        '13': '13',
      }
    }
  }
}

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

任意值

如果你需要使用一次性 `grid-row/grid-row-start/grid-row-end` 值,而该值不适合包含在你的主题中,请使用方括号使用任意值动态生成属性。

<div class="row-[span_16_/_span_16]">
  <!-- ... -->
</div>

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