grid-template

Baseline 已廣泛支援

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

grid-template CSS 屬性是用於定義網格列、網格行和網格區域的簡寫屬性。

試一試

grid-template:
  "a a a" 40px
  "b c c" 40px
  "b c c" 40px / 1fr 1fr 1fr;

grid-template:
  "b b a" auto
  "b b c" 2ch
  "b b c" 1em / 20% 20px 1fr;

grid-template:
  "a a ." minmax(50px, auto)
  "a a ." 80px
  "b b c" auto / 2em 3em 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>
  </div>
</section>

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

#example-element :nth-child(1) {
  background-color: rgb(0 0 255 / 0.2);
  border: 3px solid blue;
  grid-area: a;
}

#example-element :nth-child(2) {
  background-color: rgb(255 0 200 / 0.2);
  border: 3px solid rebeccapurple;
  grid-area: b;
}

#example-element :nth-child(3) {
  background-color: rgb(94 255 0 / 0.2);
  border: 3px solid green;
  grid-area: c;
}

構成屬性

此屬性是以下 CSS 屬性的簡寫：

語法

css

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

/* grid-template-rows / grid-template-columns values */
grid-template: 100px 1fr / 50px 1fr;
grid-template: auto 1fr / auto 1fr auto;
grid-template: [line-name] 100px / [column-name1] 30% [column-name2] 70%;
grid-template: fit-content(100px) / fit-content(40%);

/* grid-template-areas grid-template-rows / grid-template-column values */
grid-template:
  "a a a"
  "b b b";
grid-template:
  "a a a" 20%
  "b b b" auto;
grid-template:
  [header-top] "a a a" [header-bottom]
  [main-top] "b b b" 1fr [main-bottom]
  / auto 1fr auto;

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

值

none: 將所有三個長手屬性設定為 none，表示沒有顯式網格。沒有命名的網格區域。行和列將隱式生成；它們的尺寸將由 grid-auto-rows 和 grid-auto-columns 屬性決定。這是預設值。
<'grid-template-rows'> / <'grid-template-columns'>: 將 grid-template-rows 和 grid-template-columns 設定為指定值，並將 grid-template-areas 設定為 none。
[ <line-names>? <string> <track-size>? <line-names>? ]+ [ / <explicit-track-list> ]?: 將 grid-template-areas 設定為列出的字串，將 grid-template-rows 設定為每個字串後面的軌道尺寸（對於任何缺失的尺寸，填充 auto），並在每個尺寸之前/之後拼接定義的命名線，並將 grid-template-columns 設定為斜槓後指定的軌道列表（如果未指定，則為 none）。

注意：在這些軌道列表中不允許使用 repeat() 函式，因為軌道旨在與“ASCII 藝術”中的行/列視覺上進行一對一的對齊。

注意：grid 簡寫接受相同的語法，但也會將隱式網格屬性重置為其初始值。使用 grid（而不是 grid-template）可以防止這些值單獨級聯。

正式定義

初始值	作為簡寫中的每個屬性 `grid-template-columns`: `none` `grid-template-rows`: `none` `grid-template-areas`: `none`
應用於	網格容器
繼承性	否
百分比	作為簡寫中的每個屬性 `grid-template-columns`: 指內容區域的相應維度 `grid-template-rows`: 指內容區域的相應維度
計算值	作為簡寫中的每個屬性 `grid-template-columns`: 按指定，但相對長度轉換為絕對長度 `grid-template-rows`: 按指定，但相對長度轉換為絕對長度 `grid-template-areas`: 按指定
動畫型別	作為簡寫中的每個屬性 `grid-template-columns`: 長度、百分比或 calc 的簡單列表，前提是唯一的區別在於列表中長度、百分比或 calc 元件的值 `grid-template-rows`: 長度、百分比或 calc 的簡單列表，前提是唯一的區別在於列表中長度、百分比或 calc 元件的值 `grid-template-areas`: 離散

正式語法

grid-template = 
  none                                                |
  [ <'grid-template-rows'> / <'grid-template-columns'> ]  |
  [ <line-names>? <string> <track-size>? <line-names>? ]+ [ / <explicit-track-list> ]?  

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

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

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

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

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

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

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

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

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

示例

定義網格模板

CSS

css

#page {
  display: grid;
  width: 100%;
  height: 200px;
  grid-template:
    [header-left] "head head" 30px [header-right]
    [main-left] "nav  main" 1fr [main-right]
    [footer-left] "nav  foot" 30px [footer-right]
    / 120px 1fr;
}

header {
  background-color: lime;
  grid-area: head;
}

nav {
  background-color: lightblue;
  grid-area: nav;
}

main {
  background-color: yellow;
  grid-area: main;
}

footer {
  background-color: red;
  grid-area: foot;
}

HTML

html

<div id="page">
  <header>Header</header>
  <nav>Navigation</nav>
  <main>Main area</main>
  <footer>Footer</footer>
</div>

結果

規範

規範
CSS 網格佈局模組 Level 2 # 顯式網格簡寫

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面由 MDN 貢獻者於 2025年7月14日最後修改。

在 GitHub 上檢視此頁面 • 報告此內容的問題