Propriété CSS row-gap
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2017.
La propriété CSS row-gap définit la taille des espaces (gouttières) entre les rangées d'un élément dans les mises en page à plusieurs colonnes, les boîtes flexibles et les grilles.
Exemple interactif
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>Un</div>
<div>Deux</div>
<div>Trois</div>
<div>Quatre</div>
<div>Cinq</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;
}
Syntaxe
/* Valeurs avec un mot-clé */
row-gap: normal;
/* Valeurs de type <length-percentage> */
row-gap: 20px;
row-gap: 1em;
row-gap: 3vmin;
row-gap: 0.5cm;
row-gap: 10%;
row-gap: calc(10% - 6px);
/* Valeurs de type <line-width> */
row-gap: thin;
row-gap: medium;
row-gap: thick;
/* Valeurs globales */
row-gap: inherit;
row-gap: initial;
row-gap: revert;
row-gap: revert-layer;
row-gap: unset;
Valeurs
Cette propriété est définie comme une seule valeur parmi la liste suivante :
normal-
Pour la disposition multi-colonnes, équivaut à
1em; sinon0. C'est la valeur par défaut. <line-width>-
Définit la taille de la gouttière en utilisant les mots-clés
thin,mediumouthick, ou une valeur positive de type<length>. <length-percentage>-
Définit une valeur non négative de type
<length>ou<percentage>. Les pourcentages sont relatifs à la taille de l'axe de bloc de la boîte de contenu ou à0.
Description
La propriété row-gap définit la taille de l'espace entre les lignes d'un élément.
Cet espace peut contenir un séparateur visible servant de décoration. S'il existe une ligne entre les lignes, elle apparaît au milieu de l'espace, mais n'a aucune incidence sur la taille de celui-ci. Ces lignes décoratives peuvent être ajoutées à cet « espace vide » à l'aide de la propriété row-rule ou la propriété raccourcie rule.
Définie dans les espaces CSS, cette propriété peut être utilisée dans les mises en page à plusieurs colonnes, les boîtes flexibles et les grilles. La propriété row-gap, ainsi que la propriété column-gap, peut également être définie à l'aide de la propriété raccourcie gap, dans cet ordre. La propriété row-gap a remplacé la propriété grid-row-gap, qui était limitée aux mises en page en grille CSS. Désormais, grid-row-gap est un alias de row-gap.
Cette propriété définit un espacement fixe entre les éléments d'un conteneur, séparant les boîtes selon l'axe de bloc du conteneur. Les valeurs négatives ne sont pas valides. La valeur par défaut normal correspond à 1em pour les conteneurs à plusieurs colonnes, et à 0 dans tous les autres cas. Voir Définir les espaces CSS pour plus d'informations sur les espaces selon le type de mise en page.
Les pourcentages sont résolus par rapport à la taille de la boîte de contenu de l'élément conteneur sur l'axe de bloc lorsque cette taille est définie, et par rapport à 0 dans le cas contraire, sauf dans les mises en page en grille, pour lesquelles les tailles en pourcentage cycliques sont calculées par rapport à zéro pour déterminer les contributions à la taille intrinsèque, mais par rapport à la boîte de contenu de l'élément lors de la mise en page du contenu. Voir Définir les valeurs d'écart en pourcentage pour plus d'informations.
Dans les mises en page en grille, l'effet de l'espacement est tel que les lignes de grille entre les lignes de la grille acquièrent l'épaisseur correspondant à la valeur de la propriété : la piste de grille entre deux lignes correspond à l'espace entre les marges intérieures qui les représentent. En ce qui concerne le dimensionnement des pistes, chaque gouttière est traitée comme une piste supplémentaire, vide et de taille fixe, correspondant à la taille définie, qui est occupée par tout élément de grille s'étendant sur plusieurs lignes. Bien qu'elle soit considérée comme vide pour le dimensionnement, l'espace créé peut contenir un élément row-rule.
Définition formelle
| Valeur initiale | normal |
|---|---|
| Applicabilité | éléments multi-colonnes, conteneurs flexibles, conteneurs de grille |
| Héritée | non |
| Pourcentages | fait référence à la dimension correspondante de la zone de contenu |
| Valeur calculée | tel que défini, avec des longueurs (<length>) rendues absolues, et normal calculé à zéro sauf sur les éléments multi-colonnes |
| Type d'animation | une longueur, pourcentage ou calc() ; |
Syntaxe formelle
row-gap =
normal |
<length-percentage [0,∞]> |
<line-width>
<length-percentage> =
<length> |
<percentage>
<line-width> =
<length [0,∞]> |
hairline |
thin |
medium |
thick
Exemples
>Disposition flexible
Cet exemple montre comment utiliser la propriété row-gap pour créer un espace horizontal entre les lignes adjacentes d'éléments flexibles. Il montre également comment la taille de row-gap n'est pas affectée par la taille de la règle de ligne.
HTML
Nous incluons six éléments dans un élément conteneur :
<div id="boite-flexible">
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
</div>
CSS
Nous définissons le display sur flex, définissons le flex-flow sur row wrap pour créer un conteneur flexible avec des lignes d'éléments flexibles qui se déplacent sur de nouvelles lignes si nécessaire, et limitons la width à 300px. Nous ajoutons également une row-rule, qui dessine une ligne magenta en pointillés de 30px de large au milieu de l'espace.
La valeur de row-gap est définie sur 20px sur le conteneur flexible pour créer un espace de 20px entre les lignes flexibles adjacentes.
Nous définissons également une couleur de fond sur les éléments flexibles, la plupart étant semi-opaques, pour montrer comment la règle est visible sous les éléments flexibles lorsqu'elle est plus large que l'espace.
#boite-flexible {
display: flex;
flex-flow: row wrap;
width: 300px;
row-rule: 30px dashed magenta;
row-gap: 20px;
}
#boite-flexible > div {
border: 1px solid green;
background-color: #00ff0033;
flex: 1 1 100px;
height: 50px;
}
#boite-flexible > div:nth-of-type(3n-1) {
background-color: lime;
}
Résultat
Pour définir un espace vertical entre les éléments flexibles, définissez une valeur non nulle pour la propriété column-gap, en définissant éventuellement à la fois row-gap et column-gap en utilisant le raccourci gap.
Disposition en grille
Cet exemple montre comment utiliser la propriété row-gap avec une valeur en <pourcentage> dans une disposition en grille.
HTML
Nous incluons cinq éléments dans un élément conteneur :
<div id="grille">
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
</div>
CSS
Nous définissons la propriété display sur grid, la height sur 240px, la width sur 350px et grid-template-rows sur repeat(3, 1fr) pour créer un conteneur de grille de 350px de large avec trois colonnes et autant de lignes que nécessaire. Chaque ligne mesure 100px de haut, comme défini par la propriété grid-template-rows.
La valeur de row-gap est définie sur 5%. La hauteur du conteneur est de 240px. La valeur 5% crée un espace entre les lignes de 12px de haut, laissant 216px pour trois lignes d'éléments de grille, ce qui signifie que chaque ligne mesure 72px de haut.
#grille {
display: grid;
height: 240px;
width: 350px;
grid-template-rows: repeat(3, 1fr);
grid-template-columns: 150px 1fr;
row-gap: 5%;
}
Résultat
Spécifications
| Spécification |
|---|
| CSS Gaps Module Level 1> # column-row-gap> |
Compatibilité des navigateurs
Voir aussi
- La propriété
column-gap - La propriété raccourcie
row-rule - La propriété raccourcie
rule - La propriété raccourcie
gap - Un aperçu des espaces CSS et des propriétés de décoration des espaces
- Définir les espaces CSS
- Définir les règles CSS
- Les concepts de base des grilles CSS : les gouttières
- Le module d'espacements CSS