@@ -1587,19 +1587,21 @@ Self-Alignment Shorthand: the 'place-items' property</h3>
15871587<h2 id='gaps'>
15881588Gaps Between Boxes</h2>
15891589
1590- While 'margin' and 'padding' can be used to specify visual separation between individual boxes,
1591- it's sometimes more desirable to specify a "global" separation between entire groups of boxes
1592- within a given layout context.
1593- For example, an author may want some amount of empty space
1594- between the columns in the <a>multi-column element</a> ,
1595- without having to individually tune the margins on every single child of the multicol.
1590+ While 'margin' and 'padding' can be used to specify visual spacing around individual boxes,
1591+ it's sometimes more convenient to globally specify spacing between adjacent boxes
1592+ within a given layout context,
1593+ particularly when the spacing is different between boxes
1594+ as opposed to between the first/last box and the container's edge.
15961595
15971596The 'gap' property,
15981597and its 'row-gap' and 'column-gap' sub-properties,
1599- provide this functionality for some layout modes.
1598+ provide this functionality for
1599+ <a href="http://www.w3.org/TR/css3-multicol/">multi-column</a>
1600+ <a href="http://www.w3.org/TR/css-flexbox/">flex</a> ,
1601+ and <a href="http://www.w3.org/TR/css-grid/">grid layout</a> .
16001602
16011603<h3 id='column-row-gap'>
1602- The 'column-gap', 'row-gap', and 'gap' Properties </h3>
1604+ Row and Column Gutters: the 'row-gap' and 'column- gap' properties </h3>
16031605
16041606 <pre class='propdef'>
16051607 Name : row-gap, column-gap
@@ -1613,30 +1615,32 @@ The 'column-gap', 'row-gap', and 'gap' Properties</h3>
16131615 Animatable : as length, percentage, or calc
16141616 </pre>
16151617
1616- These properties specify the <dfn export lt="gutter">gutters</dfn>
1618+ These properties specify fixed-length <dfn export lt="gutter">gutters</dfn>
16171619 between items in the container,
1618- similar to the <a>content-distribution properties</a> .
1620+ adding space in a manner to the ''justify-content/space-between'' keyword
1621+ of the <a>content-distribution properties</a> ,
1622+ but of a fixed size instead of as a fraction of remaining space.
1623+
16191624 Different layout modes interpret these slightly differently:
1620- for Multicol Layout, it's the spacing between column boxes;
1625+ for Multi-column Layout, it's a minimum spacing between column boxes;
16211626 for Flex Layout, it's a minimum spacing between <a>flex items</a>
16221627 and/or <a>flex lines</a> ;
16231628 for Grid Layout, it's a minimum spacing between <a>grid tracks</a> .
1624-
16251629 Regardless of layout mode, however,
16261630 the directions that these two properties apply in are constant.
1627- 'column-gap' indicates spacing between " columns" --
1631+ 'column-gap' indicates spacing between “ columns” --
16281632 it separates boxes in the container's <a>inline axis</a> ,
16291633 similar to <a>inline-axis</a> 'margin' --
1630- while 'row-gap' indicates spacing between " rows" ,
1634+ while 'row-gap' indicates spacing between “ rows” ,
16311635 separating boxes in the container's <a>block axis</a> .
16321636
1633- Their values are defined as :
1637+ Values have the following meanings :
16341638
16351639 <dl dfn-type=value dfn-for="row-gap, column-gap, gap">
16361640 : <<length-percentage>>
16371641 ::
1638- Specifies a gap between " rows" or " columns".
1639- Precisely what this means is defined by each layout mode ;
1642+ Specifies a gap between “ rows” or “ columns”,
1643+ as defined by the layout modes to which it applies ;
16401644 see subsections below for details.
16411645
16421646 Negative values are invalid.
@@ -1648,6 +1652,8 @@ The 'column-gap', 'row-gap', and 'gap' Properties</h3>
16481652 Issue: Should ''gap/normal'' just compute to ''1em'' in multicol?
16491653 </dl>
16501654
1655+ Note: Additional spacing may be added by 'justify-content' /'align-content' .
1656+ This space effectively increases the size of these <a>gutters</a> .
16511657
16521658<h4 id='gap-multicol'>
16531659Multicol Containers</h4>
@@ -1671,20 +1677,16 @@ Grid Containers</h4>
16711677 define the [=gutters=] between <a>grid rows</a> and <a>grid columns</a> .
16721678 See [[css-grid-1#gutters]] for precise details on how this works.
16731679
1674- The ''gap/normal'' value behaves as ''0'' for both properties.
1675-
16761680<h4 id='gap-table'>
16771681Tables</h4>
16781682
16791683 Table boxes do not use the 'gap' properties to specify separation between their cells.
16801684 Instead, they use the 'border-spacing' property,
1681- which has slightly different functionality--
1685+ which has slightly different functionality:
16821686 it inherits,
1683- and it also specifies the separation between the outermost cells
1684- and the border of the table.
1685- (The 'gap' properties only specify separation between boxes in the container;
1686- they rely on the author using 'padding' if they want separation
1687- between the container's border and its contents.)
1687+ and it also specifies the additional spacing between the outermost cells
1688+ and the border of the table
1689+ (similar to ''space-evenly'' rather than ''space-between'' ).
16881690
16891691<h3 id='gap-shorthand'>
16901692Gap Shorthand: the 'gap' property</h3>
@@ -1721,7 +1723,7 @@ Legacy Gap Properties: the 'grid-row-gap', 'grid-column-gap', and 'grid-gap' pro
17211723
17221724 The Grid Layout module was originally written with its own set of [=gutter=] properties,
17231725 before all such properties were unified into the existing 'row-gap' /'column-gap' naming.
1724- For legacy compatibility ,
1726+ For compatibility with legacy content ,
17251727 those legacy property names must be supported as aliases:
17261728
17271729 * <dfn property>grid-row-gap</dfn> must be treated as a shorthand for the 'row-gap' property
@@ -1731,7 +1733,6 @@ Legacy Gap Properties: the 'grid-row-gap', 'grid-column-gap', and 'grid-gap' pro
17311733 In all three cases, the legacy properties must take the same grammar as the property they are aliasing,
17321734 and just "forward" the value to their aliased property.
17331735
1734-
17351736<!--
17361737████████ ███ ██████ ████████ ██ ████ ██ ██ ████████
17371738██ ██ ██ ██ ██ ██ ██ ██ ██ ███ ██ ██
0 commit comments