column-gap

La propriété column-gap permet de définir l'espace entre les colonnes d'un élément.

Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !

La propriété column-gap était initialement définie dans le module de spécification Multi-column Layout (disposition en colonnes). 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. Cette propriété peut être utilisée pour les dispositions en colonnes, les dispositions flexibles ou les disposition 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: 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.

Syntaxe formelle

normal | <length-percentage>
où 
<length-percentage> = <length> | <percentage>

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: 1opx solid green;
  background-color: lime;
  flex: auto;
}

Résultat

Disposition en 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

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 {
  background-color: lime;
}

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

Résultat

Spécifications

Compatibilité des navigateurs

Prise en charge pour les dispositions flexibles

Prise en charge pour les dispositions en grille

Prise en charge pour les dispositions en colonnes

Voir aussi

• row-gap
• gap
• Guide sur les boîtes flexibles : Concepts de base des flexbox
• Guide sur les grilles : Concepts de base des grilles : les gouttières
• Guide sur la disposition multi-colonnes : Mettre en forme les colonnes