网格行开始/结束

​基本用法

¥Basic usage

​跨行

¥Spanning rows

使用 row-span-* 工具使元素跨越 n 行。

¥Use the row-span-* utilities to make an element span n rows.

<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>

​起始行和结束行

¥Starting and ending lines

使用 row-start-* 和 row-end-* 工具使元素在第 n 条网格线开始或结束。这些也可以与 row-span-* 工具结合使用以跨越特定数量的行。

¥Use the row-start-* and row-end-* utilities to make an element start or end at the nth grid line. These can also be combined with the row-span-* utilities to span a specific number of rows.

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

¥Note that CSS grid lines start at 1, not 0, so a full-height element in a 3-row grid would start at line 1 and end at line 4.

<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 lets you conditionally apply utility classes in different states using variant modifiers. For example, use hover:row-span-4 to only apply the row-span-4 utility on hover.

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

For a complete list of all available state modifiers, check out the Hover, Focus, & Other States documentation.

​断点和媒体查询

You can also use variant modifiers to target media queries like responsive breakpoints, dark mode, prefers-reduced-motion, and more. For example, use md:row-span-4 to apply the row-span-4 utility at only medium screen sizes and above.

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

To learn more, check out the documentation on Responsive Design, Dark Mode and other media query modifiers.

​使用自定义值

¥Using custom values

​自定义主题

¥Customizing your theme

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

¥By default, Tailwind includes grid-row utilities for working with grids with up to 6 explicit rows. You can customize these values by editing theme.gridRow, theme.extend.gridRow, theme.gridRowStart, theme.extend.gridRowStart, theme.gridRowEnd, and theme.extend.gridRowEnd in your tailwind.config.js file.

要添加新的 row-* 工具，请自定义 Tailwind 主题配置的 gridRow 部分：

¥To add new row-* utilities, customize the gridRow section of your Tailwind theme config:

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

我们在内部将其用于我们的 row-span-* 工具。请注意，由于这直接配置了 grid-row 简写属性，我们直接在值名称中包含单词 span，它不会自动融入类名称中。这意味着你可以自由添加条目来执行你想要的任何操作 - 它们不必只是 span 工具。

¥We use this internally for our row-span-* utilities. Note that since this configures the grid-row shorthand property directly, we include the word span directly in the value name, it’s not baked into the class name automatically. That means you are free to add entries that do whatever you want here — they don’t just have to be span utilities.

要添加新的 row-start-* 工具，请自定义 Tailwind 主题配置的 gridRowStart 部分：

¥To add new row-start-* utilities, customize the gridRowStart section of your Tailwind theme config:

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

要添加新的 row-end-* 工具，请自定义 Tailwind 主题配置的 gridRowEnd 部分：

¥To add new row-end-* utilities, customize the gridRowEnd section of your Tailwind theme config:

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

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

¥Learn more about customizing the default theme in the theme customization documentation.

​任意值

¥Arbitrary values

If you need to use a one-off grid row value that doesn’t make sense to include in your theme, use square brackets to generate a property on the fly using any arbitrary value.

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

Learn more about arbitrary value support in the arbitrary values documentation.