The grid-column-gap
CSS property specifies the gutter between grid columns.
/* <length> values */ grid-column-gap: 20px; grid-column-gap: 1em; grid-column-gap: 3vmin; grid-column-gap: 0.5cm; /* <percentage> value */ grid-column-gap: 10%; /* Global values */ grid-column-gap: inherit; grid-column-gap: initial; grid-column-gap: unset;
The effect is as though the affected grid lines acquired width: the grid track between two grid lines is the space between the gutters that represent them. For the purpose of track sizing, each gutter is essentially treated as an extra track of the specified length. Negative values are invalid.
Initial value | 0 |
---|---|
Applies to | grid containers |
Inherited | no |
Percentages | yes, as the dimension of the element |
Media | visual |
Computed value | the percentage as specified or the absolute length |
Animation type | a length |
Canonical order | the unique non-ambiguous order defined by the formal grammar |
Syntax
Values
<length-percentage>
- Is the width of the gutter separating the grid columns.
<percentage>
values are relative to the dimension of the element.
Formal syntax
<length-percentage>where
<length-percentage> = <length> | <percentage>
Example
HTML Content
<div id="grid"> <div></div> <div></div> <div></div> </div>
CSS Content
#grid { display: grid; height: 100px; grid-template-columns: repeat(3, 1fr); grid-template-rows: 100px; grid-column-gap: 20px; } #grid > div { background-color: lime; }
Specifications
Specification | Status | Comment |
---|---|---|
CSS Grid Layout The definition of 'grid-column-gap' in that specification. |
Candidate Recommendation | Initial definition |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Edge | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 57.0[1] | 52.0 (52.0)[2] | No support[3] | No support[3] | 44[1] | No support[5] |
Feature | Android Webview | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | 57.0[1] | 57.0[1] | 52.0 (52.0)[2] | No support[3] | 44 | No support |
[1] Implemented behind the experimental Web Platform features flag in chrome://flags
since Chrome 29.0.
[2] Implemented behind the preference layout.css.grid.enabled
since Gecko 40.0 (Firefox 40.0 / Thunderbird 40.0 / SeaMonkey 2.37), defaulting to false
. Since Gecko 52.0 (Firefox 52.0 / Thunderbird 52.0 / SeaMonkey 2.49) it is enabled by default.
[3] Internet Explorer implements an older version of the specification, which didn't define this property.
[4] Implemented behind the Enable experimental Web Platform features flag in chrome://flags
since Opera 28.0.
[5] Experimental implementation available in Safari Technological Preview.
See also
- Related CSS properties:
grid-row-gap
,grid-gap
- Grid Layout Guide: Basic concepts of grid layout - Gutters