1. 開発者向けのウェブ技術
  2. CSS
  3. リファレンス
  4. プロパティ
  5. grid-template

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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
/* キーワード値 */
grid-template: none;
/* grid-template-rows / grid-template-columns の値 */
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 の値 */
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;
/* グローバル値 */
grid-template: inherit;
grid-template: initial;
grid-template: revert;
grid-template: revert-layer;
grid-template: unset;

値

none

3 個すべてのプロパティの値に 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() 関数を使うことはできません。トラックは「アスキーアート」内の行列と一対一の関係で視覚的に並んでいるためです。

メモ: grid 一括指定プロパティは同じ構文を受け入れますが、暗黙的なグリッドプロパティをその初期値にリセットしてしまいます。これらの値が別々にカスケードされないようにするには、(grid-template ではなく) grid を使用してください。

公式定義

初期値 一括指定の次の各プロパティとして
適用対象グリッドコンテナー
継承 なし
パーセント値一括指定の次の各プロパティとして
計算値 一括指定の次の各プロパティとして
アニメーションの種類 一括指定の次の各プロパティとして
  • 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>? <track-size> ] + <line-names>? ) 

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

<integer> = 
 <number-token> 

<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>
 <nav>ナビゲーション</nav>
 <main>メイン領域</main>
 <footer>フッター</footer>
</div>

結果

仕様書

仕様書
CSS Grid Layout Module Level 2
# explicit-grid-shorthand

ブラウザーの互換性

関連情報

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって に最終更新されました。

AltStyle によって変換されたページ (->オリジナル) /