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.
La propriété grid-gap est une propriété raccourcie pour grid-row-gap et grid-column-gap qui permet de définir les espaces entre les lignes et entre les colonnes d'une grille.
Si <'grid-column-gap'> n'est pas indiqué dans la règle, il aura la même valeur que <'grid-row-gap'>.
| Valeur initiale | pour chaque propriété individuelle de la propriété raccourcie : |
|---|---|
| Applicabilité | conteneurs de grille |
| Héritée | non |
| Média | visuel |
| Valeur calculée | pour chaque propriété individuelle de la propriété raccourcie :
|
| Animable | pour chaque propriété individuelle de la propriété raccourcie :
|
| Ordre canonique | l'ordre unique et non-ambigu défini par la grammaire formelle |
Syntaxe
/* Une valeur de longueur */ /* Type <length> */ grid-gap: 20px; grid-gap: 1em; grid-gap: 3vmin; grid-gap: 0.5cm; /* Une valeur proportionnelle */ /* Type <percentage> */ grid-gap: 16%; grid-gap: 100%; /* Deux valeurs de longueur */ grid-gap: 20px 10px; grid-gap: 1em 0.5em; grid-gap: 3vmin 2vmax; grid-gap: 0.5cm 2mm; /* Une ou deux valeurs proportionnelles */ /* Type <percentage> */ grid-gap: 16% 100%; grid-gap: 21px 82%; /* Valeurs globales */ grid-gap: inherit; grid-gap: initial; grid-gap: unset;
Valeurs
<length>- La largeur de l'espace entre les lignes et/ou entre les colonnes.
<percentage>- La largeur de l'espace entre les lignes et/ou entre les colonnes en fonction de la taille de l'élément englobant.
Syntaxe formelle
<'grid-row-gap'> <'grid-column-gap'>?
Exemples
CSS
#grid {
display: grid;
height: 200px;
grid-template: repeat(3, 1fr) / repeat(3, 1fr);
grid-gap: 20px 5px;
}
#grid > div {
background-color: lime;
}
HTML
<div id="grid"> <div></div> <div></div> <div></div> <div></div> <div></div> <div></div> <div></div> <div></div> <div></div> </div>
Résultat
Spécifications
| Spécification | État | Commentaires |
|---|---|---|
| CSS Grid Layout La définition de 'grid-gap' dans cette spécification. |
Version de travail | Définition initiale. |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Edge | Opera | Safari |
|---|---|---|---|---|---|---|
| Support simple | 29.0[1] | 40.0 (40.0)[2] | Pas de support[3] | Pas de support[3] | 28.0[1] | Nightly build-webkit |
Type <percentage> |
Pas de support | 49.0 (49.0) | Pas de support | Pas de support | Pas de support | Pas de support |
| Fonctionnalité | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Support simple | Pas de support | Pas de support | Pas de support[3] | Pas de support | Pas de support |
Type <percentage> |
Pas de support | 49.0 (49.0) | Pas de support | Pas de support | Pas de support |
[1] Cette fonctionnalité est implémentée via le marqueur fonctionnalités expérimentales de la Web Platform sous chrome://flags.
[2] Cette fonctionnalité est implémentée via la préférence layout.css.grid.enabled qui vaut false par défaut.
[3] Internet Explorer implémente une ancienne version de la spécification qui ne définit pas cette propriété.