index.md

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

{{CSSRef}}

La propriété column-gap permet de définir la taille des espaces (gouttières) entre les colonnes d'un élément.

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

La propriété column-gap était initialement définie dans le module de spécification Colonnes CSS. Cette définition a depuis été élargie afin de pouvoir être utilisée dans les différents modes de disposition et fait désormais partie du module de spécification Box Alignment (alignement des boîtes en CSS). Cette propriété peut être utilisée pour les dispositions multi-colonnes, les dispositions flexibles et les dispositions en grille.

Syntaxe

/* Valeur avec un mot-clé */
column-gap: normal;

/* Valeurs de longueur */
/* Type <length>       */
column-gap: 3px;
column-gap: 2.5em;

/* Valeurs de pourcentage */
/* Type <percentage> */
column-gap: 3%;

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

Valeurs

• normal
  • : Un mot-clé qui indique qu'on souhaite utiliser l'espacement par défaut créé par le navigateur. Pour les dispositions en colonnes, cette valeur correspond à 1em, sinon elle correspond à 0.
• <length>
  • : Une valeur de longueur (type <length>) qui définit la taille de l'espace entre les colonnes. Cette valeur peut être nulle mais ne doit pas être négative.
• <percentage>
  • : Une valeur de pourcentage (type <percentage>) qui définit la taille de l'espace entre les colonnes. Cette valeur peut être nulle mais ne doit pas être négative.

Définition formelle

{{cssinfo}}

Syntaxe formelle

{{csssyntax}}

Exemples

Disposition flexible

HTML

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

CSS

#flexbox {
  display: flex;
  height: 100px;
  column-gap: 20px;
}

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

Résultat

{{EmbedLiveSample("disposition_flexible","auto","130px")}}

Disposition en grille

HTML

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

CSS

#grid {
  display: grid;
  height: 100px;
  grid-template-columns: repeat(3, 1fr);
  grid-template-rows: 100px;
  column-gap: 20px;
}

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

Résultat

{{EmbedLiveSample("disposition_en_grille","auto", "130px")}}

Disposition multi-colonnes

HTML

<p class="content-box">
  Un texte sur plusieurs colonnes avec une gouttière de 40px paramétrée grâce à
  la propriété `column-gap`. C'est plutôt pas mal comme effet non ?
</p>

CSS

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

Résultat

{{EmbedLiveSample("disposition_multi-colonnes", "auto", "130px")}}

Spécifications

{{Specifications}}

Compatibilité des navigateurs

{{Compat}}

Voir aussi

• Les autres propriétés relatives aux gouttières : row-gap, gap
• Guide sur les grilles : Les concepts de base des grilles CSS : les gouttières
• Guide sur la disposition multi-colonnes : Mettre en forme les colonnes