row-gap CSS property
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2017 browserübergreifend verfügbar.
Die CSS-Eigenschaft row-gap legt die Größe des Abstands (gutter) zwischen den Zeilen eines Elements in mehrspaltigen Layouts, Flexbox-Layouts und Grid-Layouts fest.
Probieren Sie es aus
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;
}
Syntax
/* Keyword value */
row-gap: normal;
/* <length-percentage> value */
row-gap: 20px;
row-gap: 1em;
row-gap: 3vmin;
row-gap: 0.5cm;
row-gap: 10%;
row-gap: calc(10% - 6px);
/* <line-width> values */
row-gap: thin;
row-gap: medium;
row-gap: thick;
/* Global values */
row-gap: inherit;
row-gap: initial;
row-gap: revert;
row-gap: revert-layer;
row-gap: unset;
Werte
Diese Eigenschaft wird mit einem einzelnen Wert aus der folgenden Liste angegeben:
normal-
Wird in mehrspaltigen Layouts zu
1emaufgelöst, andernfalls zu0. Dies ist der Standardwert. <line-width>-
Legt die Größe des Abstands mit den Schlüsselwörtern
thin,mediumoderthickoder mit einem positiven<length>-Wert fest. <length-percentage>-
Legt einen nicht negativen
<length>- oder<percentage>-Wert fest. Prozentwerte beziehen sich auf die Blockgröße der Inhaltsbox oder auf0.
Beschreibung
Die Eigenschaft row-gap legt die Größe des Abstands zwischen den Zeilen eines Elements fest.
Dieser Abstand kann eine sichtbare Trennlinie als Dekoration enthalten. Wenn sich zwischen den Zeilen eine Trennlinie befindet, erscheint sie in der Mitte des Abstands, beeinflusst aber dessen Größe nicht. Solche dekorativen Linien können dem ansonsten „leeren Raum“ mit der Eigenschaft row-rule oder der Kurzschreibweise rule hinzugefügt werden.
Die in CSS-Abständen definierte Eigenschaft kann in mehrspaltigen Layouts, Flexbox-Layouts und Grid-Layouts verwendet werden. row-gap kann zusammen mit der Eigenschaft column-gap auch über die Kurzschreibweise gap festgelegt werden, und zwar in dieser Reihenfolge. Die Eigenschaft row-gap hat grid-row-gap ersetzt, die auf CSS-Grid-Layouts beschränkt war. grid-row-gap ist nun ein Alias für row-gap.
Die Eigenschaft legt einen Abstand mit fester Länge zwischen Elementen in einem Container fest und trennt dabei Boxen entlang der Blockachse des Containers. Negative Werte sind ungültig. Der Standardwert normal wird bei mehrspaltigen Containern zu 1em aufgelöst, ansonsten zu 0. Weitere Informationen zu Abständen je nach Layouttyp finden Sie unter CSS-Abstände definieren.
Prozentwerte werden anhand der Größe der Inhaltsbox des Containerelements entlang seiner Blockachse aufgelöst, wenn diese Größe eindeutig bestimmt ist, andernfalls anhand von 0. Eine Ausnahme bilden Grid-Layouts: Dort werden zyklische Prozentwerte bei der Bestimmung der Beiträge zur intrinsischen Größe anhand von null aufgelöst, beim Layout des Inhalts jedoch anhand der Inhaltsbox des Elements. Weitere Informationen finden Sie unter Abstandswerte als Prozentwerte angeben.
In Grid-Layouts wirkt sich der Abstand so aus, als erhielten die Grid-Linien zwischen den Grid-Zeilen die durch den Eigenschaftswert festgelegte Breite: Der Grid-Track zwischen zwei Zeilen ist der Raum zwischen den Abständen, die diese Zeilen begrenzen. Bei der Größenbestimmung der Tracks wird jeder Abstand als zusätzlicher, leerer Track mit der angegebenen festen Größe behandelt, über den sich alle Grid-Elemente erstrecken, die mehr als eine Zeile überspannen. Obwohl der Abstand bei der Größenbestimmung als leer gilt, kann er eine row-rule enthalten.
Formale Definition
| Anfangswert | normal |
|---|---|
| Anwendbar auf | multi-column elements, flex containers, grid containers |
| Vererbt | Nein |
| Prozentwerte | beziehen sich auf die entsprechende Dimension des Inhaltsbereichs |
| Berechneter Wert | as specified, with <length>s made absolute, and normal computing to zero except on multi-column elements |
| Animationstyp | Längenangabe, Prozentsatz oder calc(); |
Formale Syntax
row-gap =
normal |
<length-percentage [0,∞]> |
<line-width>
<length-percentage> =
<length> |
<percentage>
<line-width> =
<length [0,∞]> |
hairline |
thin |
medium |
thick
Beispiele
>Flexbox-Layout
Dieses Beispiel zeigt, wie die Eigenschaft row-gap einen horizontalen Abstand zwischen benachbarten Zeilen von Flex-Elementen erzeugt. Es zeigt außerdem, dass die Größe von row-gap nicht von der Größe der Trennlinie zwischen den Zeilen beeinflusst wird.
HTML
Wir fügen sechs Elemente in ein Containerelement ein:
<div id="flexbox">
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
</div>
CSS
Wir setzen display auf flex und flex-flow auf row wrap, um einen Flex-Container zu erstellen, dessen Flex-Elemente bei Bedarf in neue Zeilen umbrechen. Außerdem begrenzen wir width auf 300px. Wir fügen auch eine row-rule hinzu, die in der Mitte des Abstands eine 30px breite, gestrichelte, magentafarbene Linie zeichnet.
Auf dem Flex-Container setzen wir row-gap auf 20px, um zwischen benachbarten Flex-Zeilen einen Abstand von 20px zu erzeugen.
Außerdem geben wir den Flex-Elementen eine Hintergrundfarbe. Die meisten sind teilweise transparent, um zu zeigen, dass die Trennlinie unter den Flex-Elementen sichtbar ist, wenn sie breiter als der Abstand ist.
#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;
}
Ergebnis
Um einen vertikalen Abstand zwischen Flex-Elementen festzulegen, geben Sie für die Eigenschaft column-gap einen Wert ungleich null an. Optional können Sie row-gap und column-gap gemeinsam über die Kurzschreibweise gap festlegen.
Grid-Layout
Dieses Beispiel zeigt die Verwendung der Eigenschaft row-gap mit einem <percentage>-Wert in einem Grid-Layout.
HTML
Wir fügen fünf Elemente in ein Containerelement ein:
<div id="grid">
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
</div>
CSS
Wir setzen die Eigenschaft display auf grid, height auf 240px, width auf 350px und grid-template-rows auf repeat(3, 1fr). So entsteht ein 350px breiter Grid-Container mit drei Spalten und so vielen Zeilen wie nötig. Jede Zeile ist 100px hoch, wie durch die Eigenschaft grid-template-rows festgelegt.
row-gap ist auf 5% gesetzt. Die Höhe des Containers beträgt 240px. Der Wert 5% erzeugt einen Zeilenabstand von 12px und lässt 216px für drei Zeilen mit Grid-Elementen übrig. Damit ist jede Zeile 72px hoch.
#grid {
display: grid;
height: 240px;
width: 350px;
grid-template-rows: repeat(3, 1fr);
grid-template-columns: 150px 1fr;
row-gap: 5%;
}
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| CSS Gaps Module Level 1> # column-row-gap> |