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

grid-template-rows

Baseline 廣泛可用 *

此功能已非常成熟，可在多種裝置和瀏覽器版本上使用。自 2017 年 10 月以來，它已在各大瀏覽器中可用。

* 此特性的某些部分可能存在不同級別的支援。

grid-template-rows CSS 屬性定義了網格行的行名稱和軌道尺寸函式。

試一試

grid-template-rows: auto;

grid-template-rows: 40px 4em 40px;

grid-template-rows: 1fr 2fr 1fr;

grid-template-rows: 3ch auto minmax(10px, 60px);

<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-template-columns: 1fr 1fr;
  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-rows: none;

/* <track-list> values */
grid-template-rows: 100px 1fr;
grid-template-rows: [line-name] 100px;
grid-template-rows: [line-name1] 100px [line-name2 line-name3];
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:
  [line-name1] 100px [line-name2]
  repeat(auto-fit, [line-name3 line-name4] 300px)
  100px;
grid-template-rows:
  [line-name1 line-name2] 100px
  repeat(auto-fit, [line-name1] 300px) [line-name3];

/* 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 屬性確定。

[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

一個關鍵字，表示佔用網格軌道的網格專案的最大內容貢獻的最大值。

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-content 和 justify-content 屬性進行拉伸。因此，預設情況下，自動大小的軌道將佔用網格容器中的任何剩餘空間。

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

指示此軸應根據砌體演算法進行佈局。

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 網格佈局模組 Level 2
# track-sizing
CSS 網格佈局模組 Level 2
# subgrids

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後由 MDN 貢獻者 於 修改。

在 GitHub 上檢視此頁面 • 報告此內容問題
© . Content available under a Creative Commons license.