1. Web
  2. CSS
  3. grid-template-columns

grid-template-columns

Baseline 广泛可用 *

此功能已非常成熟，可在多种设备和浏览器版本上使用。自 2017 年 10 月以来，它已在各大浏览器中可用。

* 此特性的某些部分可能存在不同级别的支持。

CSS 属性 grid-template-columns 定义了网格列的网格线名称和轨道尺寸函数。

试一试

grid-template-columns: 60px 60px;

grid-template-columns: 1fr 60px;

grid-template-columns: 1fr 2fr;

grid-template-columns: 8ch auto;

<section class="default-example" id="default-example">
  <div class="example-container">
    <div class="transition-all" id="example-element">
      <div>One</div>
      <div>Two</div>
      <div>Three</div>
      <div>Four</div>
      <div>Five</div>
    </div>
  </div>
</section>

#example-element {
  border: 1px solid #c5c5c5;
  display: grid;
  grid-auto-rows: 40px;
  grid-gap: 10px;
  width: 200px;
}

#example-element > div {
  background-color: rgb(0 0 255 / 0.2);
  border: 3px solid blue;
}

语法

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

/* <track-list> values */
grid-template-columns: 100px 1fr;
grid-template-columns: [line-name] 100px;
grid-template-columns: [line-name1] 100px [line-name2 line-name3];
grid-template-columns: minmax(100px, 1fr);
grid-template-columns: fit-content(40%);
grid-template-columns: repeat(3, 200px);
grid-template-columns: subgrid;
grid-template-columns: masonry;

/* <auto-track-list> values */
grid-template-columns: 200px repeat(auto-fill, 100px) 300px;
grid-template-columns:
  minmax(100px, max-content)
  repeat(auto-fill, 200px) 20%;
grid-template-columns:
  [line-name1] 100px [line-name2]
  repeat(auto-fit, [line-name3 line-name4] 300px)
  100px;
grid-template-columns:
  [line-name1 line-name2] 100px
  repeat(auto-fit, [line-name1] 300px) [line-name3];

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

值

none

表示没有显式网格。任何列都将被隐式生成，其大小将由 grid-auto-columns 属性决定。

[line-name]

一个 <custom-ident>，为该位置的网格线指定一个名称。标识符可以是除保留字 span 和 auto 之外的任何有效字符串。网格线可以有多个名称，在方括号内用空格隔开，例如 [line-name-a line-name-b]。

<length>

一个非负长度值，指定列的宽度。

<percentage>

一个非负的 <percentage> 值，相对于网格容器的行内尺寸。如果网格容器的尺寸取决于其轨道的尺寸，则浏览器将百分比视为 auto。浏览器可能会调整轨道对网格容器尺寸的固有尺寸贡献，并可能通过最小化增加轨道的最终尺寸来满足百分比要求。

<flex>

是一个带有 fr 单位的非负维度，指定了轨道的弹性系数。每个 <flex> 尺寸的轨道会按其弹性系数的比例分配剩余空间。

当出现在 minmax() 函数之外时，它表示一个自动的最小值（即 minmax(auto, <flex>)）。

max-content

是一个关键字，表示占据网格轨道的网格项中最大的最大内容贡献。例如，如果网格轨道的第一个元素包含句子“Repetitio est mater studiorum”，第二个元素包含句子“Dum spiro, spero”，那么最大内容贡献将由所有网格元素中最大句子的尺寸定义——即“Repetitio est mater studiorum”。

min-content

是一个关键字，表示占据网格轨道的网格项中最大的最小内容贡献。例如，如果网格轨道的第一个元素包含句子“Repetitio est mater studiorum”，第二个元素包含句子“Dum spiro, spero”，那么最小内容贡献将由网格元素中所有句子里的最长单词的尺寸来定义——即“studiorum”。

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-content 和 justify-content 属性拉伸。因此，默认情况下，一个 auto 尺寸的轨道将占据网格容器中的任何剩余空间。

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

代表公式 max(minimum, min(limit, max-content))，其中 minimum 代表一个 auto 最小值（通常但不总是等于 min-content 最小值），limit 是作为参数传递给 fit-content() 的轨道尺寸函数。这本质上相当于计算 minmax(auto, max-content) 和 minmax(auto, limit) 中的较小值。

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

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

masonry

masonry 值表示该轴应根据瀑布流算法进行布局。

subgrid

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

正式定义

初始值none
应用于网格容器
继承性否
百分比参照内容区域的相应维度
计算值按指定值，但相对长度会转换为绝对长度。
动画类型由长度、百分比或 calc 组成的简单列表，前提是唯一的区别在于列表中长度、百分比或 calc 组件的值

正式语法

grid-template-columns = 
  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;
  width: 100%;
  grid-template-columns: 50px 1fr;
}

#areaA {
  background-color: lime;
}

#areaB {
  background-color: yellow;
}

结果

规范

规范
CSS 网格布局模块 Level 2
# 轨道尺寸
CSS 网格布局模块 Level 2
# subgrids

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后修改于 ，由 MDN 贡献者撰写。

在 GitHub 上查看此页面 • 报告此内容的问题
© . Content available under a Creative Commons license.