grid-template-rows

基线 广泛可用

此功能已得到充分建立,可在许多设备和浏览器版本中使用。它自以下时间起在所有浏览器中都可用 2020 年 7 月.

grid-template-rows CSS 属性定义了 网格行 的行名和轨道大小函数。

试一试

语法

css
/* Keyword value */
grid-template-rows: none;

/* <track-list> values */
grid-template-rows: 100px 1fr;
grid-template-rows: [linename] 100px;
grid-template-rows: [linename1] 100px [linename2 linename3];
grid-template-rows: minmax(100px, 1fr);
grid-template-rows: fit-content(40%);
grid-template-rows: repeat(3, 200px);
grid-template-rows: subgrid;
grid-template-rows: masonry;

/* <auto-track-list> values */
grid-template-rows: 200px repeat(auto-fill, 100px) 300px;
grid-template-rows:
  minmax(100px, max-content)
  repeat(auto-fill, 200px) 20%;
grid-template-rows:
  [linename1] 100px [linename2]
  repeat(auto-fit, [linename3 linename4] 300px)
  100px;
grid-template-rows:
  [linename1 linename2] 100px
  repeat(auto-fit, [linename1] 300px) [linename3];

/* Global values */
grid-template-rows: inherit;
grid-template-rows: initial;
grid-template-rows: revert;
grid-template-rows: revert-layer;
grid-template-rows: unset;

此属性可以指定为

  • 关键字值 none
  • <track-list>
  • <auto-track-list> 值。

none

是一个关键字,表示没有显式网格。任何行都将隐式生成,其大小将由 grid-auto-rows 属性确定。

[linename]

一个 <custom-ident>,用于指定该位置的行的名称。标识符可以是任何有效的字符串,除了保留字 spanauto 之外。行可以有多个名称,用空格分隔,例如 [line-name-a line-name-b]

<length>

是一个非负长度。

<percentage>

是一个非负的 <percentage> 值,相对于网格容器的块大小。如果网格容器的大小取决于其轨道的尺寸,则在计算网格容器的固有尺寸时,百分比必须视为 auto。然后必须针对生成的网格容器大小解析它,以用于布置网格及其项目。轨道的固有尺寸贡献可能会调整到网格容器的大小,并且可能会通过最小量增加轨道的最终尺寸,这将导致尊重百分比。

<flex>

是一个非负维度,单位为 fr,用于指定轨道的弹性因子。每个 <flex> 大小的轨道都会根据其弹性因子按比例占用剩余空间。当出现在 minmax() 表示法之外时,它表示自动最小值(即 minmax(auto, <flex>))。

max-content

是一个关键字,表示占据网格轨道的网格项目的最大最大内容贡献。

min-content

是一个关键字,表示占据网格轨道的网格项目的最大最小内容贡献。

minmax(min, max)

是一个函数表示法,定义了一个大小范围,大于或等于 min,小于或等于 max。如果 max 小于 min,则忽略 max,并将该函数视为 min。作为最大值,<flex> 值设置轨道的弹性因子。作为最小值则无效。

auto

作为最大值,表示该轨道中项目的最大 max-content 尺寸。

作为最小值,表示该轨道中项目的最大最小尺寸(由项目的 min-width/min-height 指定)。这通常(尽管并非总是)是 min-content 尺寸。

如果在 minmax() 表示法之外使用,则 auto 表示上述最小值和最大值之间的范围。在大多数情况下,它的行为类似于 minmax(min-content,max-content)

注意:auto 轨道尺寸(并且只有 auto 轨道尺寸)可以通过 align-contentjustify-content 属性进行拉伸。因此,默认情况下,auto 尺寸的轨道将占用网格容器中任何剩余的空间。

fit-content( [ <length> | <percentage> ] )

表示公式 min(max-content, max(auto, argument)),其计算方式类似于 auto(即 minmax(auto, max-content)),不同之处在于,如果轨道尺寸大于 auto 最小值,则将其限制在 argument 上。

repeat( [ <positive-integer> | auto-fill | auto-fit ] , <track-list> )

表示轨道列表的重复片段,允许以更紧凑的形式编写具有重复模式的大量行。

masonry

masonry 值表示此轴应根据 masonry 算法进行布局。

subgrid

subgrid 值表示网格将在该轴上采用其父网格的跨越部分。网格行/列的大小不会显式指定,而是从父网格的定义中获取。

正式定义

初始值none
应用于网格容器
继承
百分比指内容区域的对应尺寸
计算值如指定,但将相对长度转换为绝对长度
动画类型简单长度、百分比或 calc 列表,前提是列表中唯一的区别在于长度、百分比或 calc 组件的值

正式语法

grid-template-rows = 
none |
<track-list> |
<auto-track-list> |
subgrid <line-name-list>?

<track-list> =
[ <line-names>? [ <track-size> | <track-repeat> ] ]+ <line-names>?

<auto-track-list> =
[ <line-names>? [ <fixed-size> | <fixed-repeat> ] ]* <line-names>? <auto-repeat> [ <line-names>? [ <fixed-size> | <fixed-repeat> ] ]* <line-names>?

<line-name-list> =
[ <line-names> | <name-repeat> ]+

<line-names> =
'[' <custom-ident>* ']'

<track-size> =
<track-breadth> |
minmax( <inflexible-breadth> , <track-breadth> ) |
fit-content( <length-percentage [0,∞]> )

<track-repeat> =
repeat( [ <integer [1,∞]> ] , [ <line-names>? <track-size> ]+ <line-names>? )

<fixed-size> =
<fixed-breadth> |
minmax( <fixed-breadth> , <track-breadth> ) |
minmax( <inflexible-breadth> , <fixed-breadth> )

<fixed-repeat> =
repeat( [ <integer [1,∞]> ] , [ <line-names>? <fixed-size> ]+ <line-names>? )

<auto-repeat> =
repeat( [ auto-fill | auto-fit ] , [ <line-names>? <fixed-size> ]+ <line-names>? )

<name-repeat> =
repeat( [ <integer [1,∞]> | auto-fill ] , <line-names>+ )

<track-breadth> =
<length-percentage [0,∞]> |
<flex [0,∞]> |
min-content |
max-content |
auto

<inflexible-breadth> =
<length-percentage [0,∞]> |
min-content |
max-content |
auto

<length-percentage> =
<length> |
<percentage>

<fixed-breadth> =
<length-percentage [0,∞]>

示例

指定网格行大小

HTML

html
<div id="grid">
  <div id="areaA">A</div>
  <div id="areaB">B</div>
</div>

CSS

css
#grid {
  display: grid;
  height: 100px;
  grid-template-rows: 30px 1fr;
}

#areaA {
  background-color: lime;
}

#areaB {
  background-color: yellow;
}

结果

规范

规范
CSS 网格布局模块级别 2
# 轨道大小调整
CSS 网格布局模块级别 2
# 子网格

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅