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.
Note : Le module de spécification CSS Grid Layout définissait initialement la propriété grid-column-gap
. Cette version préfixée a été remplacée par column-gap
. Toutefois, à des fins de compatibilité envers les navigateurs qui ne prendraient pas en charge cette évolution, mieux vaut utiliser les deux versions (voir l'exemple interactif ci-avant).
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
Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.
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;
}
Résultat
Spécifications
Spécification | État | Commentaires |
---|---|---|
CSS Box Alignment Module Level 3 La définition de 'column-gap' dans cette spécification. |
Version de travail | Applique cette propriété aux grilles et aux boîtes flexibles (flexbox). |
CSS Grid Layout La définition de 'column-gap' dans cette spécification. |
Candidat au statut de recommandation | Définition de l'impact de cette propriété sur les dispositions en grille. |
CSS Multi-column Layout Module La définition de 'column-gap' dans cette spécification. |
Version de travail | Définition initiale. |
Valeur initiale | normal |
---|---|
Applicabilité | multi-column elements, flex containers, grid containers |
Héritée | non |
Pourcentages | fait référence à la dimension correspondante de la zone de contenu |
Valeur calculée | as specified, with <length>s made absolute, and normal computing to zero except on multi-column elements |
Type d'animation | une longueur, pourcentage ou calc() ; |
Compatibilité des navigateurs
Prise en charge pour les dispositions flexibles
BCD tables only load in the browser
Prise en charge pour les dispositions en grille
BCD tables only load in the browser
Prise en charge pour les dispositions en colonnes
BCD tables only load in the browser
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