index.md

title	slug
gap (grid-gap)	Web/CSS/gap

{{CSSRef}}

La propriété gap est une propriété raccourcie pour row-gap et column-gap qui permet de définir les espaces (les gouttières) entre les lignes et entre les colonnes d'une grille.

{{EmbedInteractiveExample("pages/css/gap.html")}}

Syntaxe

/* Une valeur de longueur */
/* Type <length>          */
gap: 20px;
gap: 1em;
gap: 3vmin;
gap: 0.5cm;

/* Une valeur proportionnelle */
/* Type <percentage>          */
gap: 16%;
gap: 100%;

/* Deux valeurs de longueur */
gap: 20px 10px;
gap: 1em 0.5em;
gap: 3vmin 2vmax;
gap: 0.5cm 2mm;

/* Une ou deux valeurs proportionnelles */
/* Type <percentage>                    */
gap: 16% 100%;
gap: 21px 82%;

/* Valeurs calc() */
gap: calc(10% + 20px);
gap: calc(20px + 10%) calc(10% - 5px);

/* Valeurs globales */
gap: inherit;
gap: initial;
gap: revert;
gap: unset;

Cette propriété est définie avec une valeur <'row-gap'>, éventuellement suivi d'une valeur <'column-gap'>. Si <'column-gap'> n'est pas défini, la valeur utilisée sera la même que <'row-gap'>.

<'row-gap'> et <'column-gap'> sont des valeurs de type <length> ou <percentage>.

Valeurs

• <length>
  • : La largeur de l'espace entre les pistes de grille.
• <percentage>
  • : La largeur de l'espace entre les pistes de grille en fonction de la taille de l'élément englobant.

Définition formelle

{{cssinfo}}

Syntaxe formelle

{{csssyntax}}

Exemples

Disposition flexible

HTML

<div id="flexbox">
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
</div>

CSS

#flexbox {
  display: flex;
  flex-wrap: wrap;
  width: 300px;
  gap: 20px 5px;
}

#flexbox > div {
  border: 1px solid green;
  background-color: lime;
  flex: 1 1 auto;
  width: 100px;
  height: 50px;
}

Résultat

{{EmbedLiveSample("Disposition flexible", "auto", "230px")}}

Disposition en grille

HTML

<div id="grid">
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
</div>

CSS

#grid {
  grid-gap: 20px 5px;
}

#grid {
  display: grid;
  height: 200px;
  grid-template: repeat(3, 1fr) / repeat(3, 1fr);
  gap: 20px 5px;
}

#grid > div {
  border: 1px solid green;
  background-color: lime;
}

Résultat

{{EmbedLiveSample("Disposition en grille", "auto", "230px")}}

Disposition multi-colonnes

HTML

<p class="content-box">
  Voici un texte en multi-colonne sur des colonnes avec une gouttière de 40px
  créée grâce à la propriété CSS <code>gap</code>. Est-ce que c'est pas trop
  génial ?
</p>

CSS

.content-box {
  column-count: 3;
  gap: 40px;
}

Résultat

{{EmbedLiveSample("Disposition multi-colonnes", "auto", "120px")}}

Spécifications

{{Specifications("css.properties.gap.grid_context")}}

Compatibilité des navigateurs

{{Compat}}

Voir aussi

• Les autres propriétés relatives aux gouttières : row-gap, column-gap
• Guide sur les grilles : Les concepts de base des grilles CSS : les gouttières