row-gap プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年10月以降、すべてのブラウザーで利用可能です。
row-gap は CSS のプロパティで、段組み、フレックスボックス、グリッドレイアウトにおける要素の行間の隙間(溝)の寸法を定義します。
試してみましょう
row-gap: 0;
row-gap: 1ch;
row-gap: 1em;
row-gap: 20px;
<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;
width: 200px;
}
#example-element > div {
background-color: rgb(0 0 255 / 0.2);
border: 3px solid blue;
}
構文
/* キーワード値 */
row-gap: normal;
/* <length-percentage> 値 */
row-gap: 20px;
row-gap: 1em;
row-gap: 3vmin;
row-gap: 0.5cm;
row-gap: 10%;
row-gap: calc(10% - 6px);
/* <line-width> 値 */
row-gap: thin;
row-gap: medium;
row-gap: thick;
/* グローバル値 */
row-gap: inherit;
row-gap: initial;
row-gap: revert;
row-gap: revert-layer;
row-gap: unset;
値
このプロパティは、次のリストのいずれかを単一の値として指定します。
normal-
段組みレイアウトでは
1emに、それ以外では0に解決されます。これはデフォルト値です。 <line-width>-
thin、medium、thickのキーワード、または正の<length>値を使って隙間の大きさを設定します。 <length-percentage>-
負でない
<length>または<percentage>値を指定します。パーセント値はコンテナーのコンテンツボックスのブロックサイズを基準とし、そのサイズが確定していない場合は0を基準とします。
解説
row-gap プロパティは、要素の行間の隙間の大きさを設定します。この隙間には、隙間の装飾として可視の区切り線を含めることができます。行間罫がある場合、その線は隙間の中央に表示されますが、隙間の大きさには影響しません。row-rule プロパティまたは rule 一括指定を使用すると、通常は「空きスペース」である隙間に装飾線を追加できます。
CSS 隙間で定義されているこのプロパティは、段組み、フレックスボックス、グリッドレイアウトで使用できます。row-gap と column-gap プロパティは、この順序で gap 一括指定プロパティを使って設定することもできます。row-gap は、CSS グリッドレイアウトに限定されていた grid-row-gap プロパティに置き換わるものです。現在、grid-row-gap は row-gap の別名です。
このプロパティは、コンテナー内のアイテム間に固定長の隙間を指定し、コンテナーのブロック軸に沿ってボックスを隔てます。負の値は無効です。デフォルト値の normal は、段組みコンテナーでは 1em に、それ以外では 0 に解決されます。レイアウトの種類ごとの隙間について詳しくは、CSS 隙間の定義を参照してください。
パーセント値は、コンテナー要素のブロック軸におけるコンテンツボックスのサイズが確定している場合はそのサイズを基準に解決され、それ以外の場合は 0 を基準に解決されます。ただし、グリッドレイアウトでは、循環するパーセント値は 内在サイズへの寄与を計算する際には 0 を基準に解決されますが、内容をレイアウトする際には要素のコンテンツボックスを基準に解決されます。詳しくは、パーセント値による隙間の指定を参照してください。
グリッドレイアウトでは、隙間の効果は、行間のグリッド線がこのプロパティの値と同じ太さを持つかのようになります。2 つの行を隔てるグリッドトラックは、それらを表す隙間の間の空間です。トラックのサイズ計算では、各隙間は指定されたサイズの空の固定サイズトラックとして扱われ、複数の行にまたがるグリッドアイテムはその隙間にもまたがります。サイズ計算上は空として扱われますが、作成された隙間には row-rule を含めることができます。
公式定義
形式文法
row-gap =
normal |
<length-percentage [0,∞]> |
<line-width>
<length-percentage> =
<length> |
<percentage>
<line-width> =
<length [0,∞]> |
hairline |
thin |
medium |
thick
例
>フレックスレイアウト
この例では、row-gap プロパティを使って、フレックスアイテムの隣り合う行の間に垂直方向の隙間を作成します。また、行間罫の幅が row-gap のサイズに影響しないことも示しています。
HTML
コンテナー要素に 6 つのアイテムを含めます。
<div id="flexbox">
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
</div>
CSS
display を flex に、flex-flow を row wrap に設定して、必要に応じてフレックスアイテムが新しい行に折り返すフレックスコンテナーを作成し、width を 300px に制限します。また、隙間の中央に幅 30px のマゼンタ色の破線を引く row-rule も追加します。
フレックスコンテナーの row-gap を 20px に設定して、隣り合うフレックス行の間に 20px の隙間を作ります。
さらに、フレックスアイテムに背景色を設定します。大半を半透明にして、行間罫が隙間よりも広い場合に、フレックスアイテムの下に線が見えることを示します。
#flexbox {
display: flex;
flex-flow: row wrap;
width: 300px;
row-rule: 30px dashed magenta;
row-gap: 20px;
}
#flexbox > div {
border: 1px solid green;
background-color: #00ff0033;
flex: 1 1 100px;
height: 50px;
}
#flexbox > div:nth-of-type(3n-1) {
background-color: lime;
}
結果
フレックスアイテム間に水平方向の隙間を設定するには、column-gap プロパティに 0 以外の値を指定します。gap 一括指定を使うと、row-gap と column-gap の両方を設定することもできます。
グリッドレイアウト
この例では、グリッドレイアウトで row-gap プロパティに <percentage> 値を指定する方法を示します。
HTML
コンテナー要素に 5 つのアイテムを含めます。
<div id="grid">
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
</div>
CSS
display プロパティを grid に、height を 240px に、width を 350px に、grid-template-rows を repeat(3, 1fr) に設定して、幅 350px で 2 列 3 行のグリッドコンテナーを作成します。grid-template-rows プロパティで定義されているとおり、各行の高さは同じです。
row-gap は 5% に設定します。コンテナーの高さは 240px なので、5% による行間の隙間の高さは 12px です。残りの 216px が 3 行に分けられるため、各行の高さは 72px になります。
#grid {
display: grid;
height: 240px;
width: 350px;
grid-template-rows: repeat(3, 1fr);
grid-template-columns: 150px 1fr;
row-gap: 5%;
}
結果
仕様書
| 仕様書 |
|---|
| CSS Gaps Module Level 1> # column-row-gap> |