このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
grid-row-start
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年10月.
grid-row-start は CSS のプロパティで、グリッド行の中におけるグリッドアイテムの先頭の位置を指定します。グリッド配置に線や区間を指定したり、何も指定しなかったり(自動)することで、グリッド領域のインライン方向の先頭の端を指定します。
試してみましょう
grid-row-start: auto;
grid-row-start: 3;
grid-row-start: -1;
grid-row-start: span 2;
<section class="default-example" id="default-example">
<div class="example-container">
<div class="transition-all" id="example-element">One</div>
<div>Two</div>
<div>Three</div>
</div>
</section>
.example-container {
border: 1px solid #c5c5c5;
display: grid;
grid-template-columns: 1fr 1.5fr 1fr;
grid-template-rows: repeat(3, minmax(40px, auto));
grid-gap: 10px;
width: 200px;
}
.example-container > div {
background-color: rgba(0, 0, 255, 0.2);
border: 3px solid blue;
}
#example-element {
background-color: rgba(255, 0, 200, 0.2);
border: 3px solid rebeccapurple;
}
構文
/* キーワード値 */
grid-row-start: auto;
/* <custom-ident> 値 */
grid-row-start: some-grid-area;
/* <integer> + <custom-ident> 値 */
grid-row-start: 2;
grid-row-start: some-grid-area 4;
/* span + <integer> + <custom-ident> 値 */
grid-row-start: span 3;
grid-row-start: span some-grid-area;
grid-row-start: 5 some-grid-area span;
/* グローバル値 */
grid-row-start: inherit;
grid-row-start: initial;
grid-row-start: revert;
grid-row-start: revert-layer;
grid-row-start: unset;
このプロパティは単一の <grid-line> 値で指定します。 <grid-line> 値は次のように指定します。
autoキーワード<custom-ident>値<integer>値<custom-ident>および<integer>を空白で区切ったものspanキーワードと<custom-ident>または<integer>またはその両方。
値
auto-
プロパティをグリッドアイテムの配置に影響させず、自動的に配置し、間隔を自動的に取るか、既定の
1とするためのキーワードです。 <custom-ident>-
<custom-ident>-startという名前の付いた線がある場合、これはそのような線の先頭がグリッドアイテムの配置に関わります。メモ: 名前付きグリッド領域、自動的にこの形で暗黙の名前付き線を生成しますので、
grid-row-start: foo;と指定すると名前付きグリッド領域の先頭側の端を選択します (その前にfoo-startという名前の線が明示的に存在しない限り)。
そうでなければ、これは <custom-ident> に沿って整数の 1 が指定されたものとして扱われます。
<integer> && <custom-ident>?-
n 番目のグリッド線をグリッドアイテムの配置に使用します。負の整数が指定された場合は、逆方向にカウントし、明示的なグリッドの末尾の端から始めます。
名前が
<custom-ident>として与えられた場合、その名前の付いた線のみがカウントされます。その名前がある線の数が十分にない場合は、この位置を探す目的においては、すべての暗黙のグリッド線がその名前を持つと仮定されます。0の<integer>値は無効です。 span && [ <integer> || <custom-ident> ]-
グリッドアイテムのグリッド領域の行の先頭の端が終了の端から n 本になるように、グリッドアイテムの配置にグリッドスパンを設定します。
名前が
<custom-ident>として与えられた場合、その名前の付いた線のみがカウントされます。その名前を持つ線の数が十分にない場合は、検索方向に対応する明示的グリッドの側にあるすべての暗黙的グリッド線が、この区間をカウントする目的でその名前を持つと仮定されます。<integer> が省略された場合の既定値は
1です。負の数や0は無効です。<custom-ident>はspanの値を取ることができません。
公式定義
| 初期値 | auto |
|---|---|
| 適用対象 | 包含ブロックがグリッドコンテナーであるグリッドアイテムまたは絶対位置指定のボックス |
| 継承 | なし |
| 計算値 | 指定通り |
| アニメーションの種類 | 離散値 |
形式文法
grid-row-start =
<grid-line>
<grid-line> =
auto |
<custom-ident> |
[ [ <integer [-∞,-1]> | <integer [1,∞]> ] && <custom-ident> ? ] |
[ span && [ <integer [1,∞]> || <custom-ident> ] ]
例
グリッドアイテムの行の開始位置の設定
HTML
<div class="wrapper">
<div class="box1">One</div>
<div class="box2">Two</div>
<div class="box3">Three</div>
<div class="box4">Four</div>
<div class="box5">Five</div>
</div>
CSS
.wrapper {
display: grid;
grid-template-columns: repeat(3, 1fr);
grid-auto-rows: 100px;
}
.box1 {
grid-column-start: 1;
grid-column-end: 4;
grid-row-start: 1;
grid-row-end: 3;
}
.box2 {
grid-column-start: 1;
grid-row-start: 3;
grid-row-end: 5;
}
* {
box-sizing: border-box;
}
.wrapper {
border: 2px solid #f76707;
border-radius: 5px;
background-color: #fff4e6;
}
.wrapper > div {
border: 2px solid #ffa94d;
border-radius: 5px;
background-color: #ffd8a8;
padding: 1em;
color: #d9480f;
}
.nested {
border: 2px solid #ffec99;
border-radius: 5px;
background-color: #fff9db;
padding: 1em;
}
結果
仕様書
| Specification |
|---|
| CSS Grid Layout Module Level 2 # line-placement |
ブラウザーの互換性
Enable JavaScript to view this browser compatibility table.