Skip to content

Commit 4d5b6ae

Browse files
committed
[css-align] 3rd pass through gutters section: additional cleanup, plus define for flex layout.
1 parent c70a1bc commit 4d5b6ae

File tree

1 file changed

+35
-35
lines changed

1 file changed

+35
-35
lines changed

css-align/Overview.bs

Lines changed: 35 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1617,20 +1617,13 @@ Row and Column Gutters: the 'row-gap' and 'column-gap' properties</h3>
16171617

16181618
These properties specify fixed-length <dfn export lt="gutter">gutters</dfn>
16191619
between items in the container,
1620-
adding space in a manner to the ''justify-content/space-between'' keyword
1620+
adding space between them--
1621+
in a manner to the ''justify-content/space-between'' keyword
16211622
of the <a>content-distribution properties</a>,
16221623
but of a fixed size instead of as a fraction of remaining space.
1623-
1624-
Different layout modes interpret these slightly differently:
1625-
for Multi-column Layout, it's a minimum spacing between column boxes;
1626-
for Flex Layout, it's a minimum spacing between <a>flex items</a>
1627-
and/or <a>flex lines</a>;
1628-
for Grid Layout, it's a minimum spacing between <a>grid tracks</a>.
1629-
Regardless of layout mode, however,
1630-
the directions that these two properties apply in are constant.
1631-
'column-gap' indicates spacing between “columns”--
1632-
it separates boxes in the container's <a>inline axis</a>,
1633-
similar to <a>inline-axis</a> 'margin'--
1624+
The 'column-gap' property specifies spacing between “columns”,
1625+
separating boxes in the container's <a>inline axis</a>
1626+
similar to <a>inline-axis</a> margin;
16341627
while 'row-gap' indicates spacing between “rows”,
16351628
separating boxes in the container's <a>block axis</a>.
16361629

@@ -1652,35 +1645,42 @@ Row and Column Gutters: the 'row-gap' and 'column-gap' properties</h3>
16521645
Issue: Should ''gap/normal'' just compute to ''1em'' in multicol?
16531646
</dl>
16541647

1655-
Note: Additional spacing may be added by 'justify-content'/'align-content'.
1656-
This space effectively increases the size of these <a>gutters</a>.
1657-
1658-
<h4 id='gap-multicol'>
1659-
Multicol Containers</h4>
1660-
1661-
'column-gap' specifes the [=gutter=] between adjacent <a>column boxes</a>.
1662-
See [[CSS-MULTICOL-1]] for details on how this affects the layout of multicol elements.
1648+
Gutters effect a minimum spacing between items:
1649+
additional spacing may be added by 'justify-content'/'align-content'.
1650+
Such additional space effectively increases the size of these <a>gutters</a>.
16631651

1664-
Multicol does not currently use 'row-gap'.
1652+
The exact handling of these properties varies by layout container:
16651653

1666-
<h4 id='gap-flex'>
1667-
Flex Containers</h4>
1668-
1669-
Issue: TODO define how row-gap/column-gap work between flex items and flex lines.
1654+
<dl>
1655+
<dt id="gap-multicol"><a>multi-column elements</a>
1656+
<dd>
1657+
'column-gap' specifes the [=gutter=] between adjacent <a>column boxes</a>.
1658+
See [[CSS-MULTICOL-1]] for details on how this affects the layout of multicol elements.
1659+
'row-gap' does not currently apply.
16701660

1671-
<h4 id='gap-grid'>
1672-
Grid Containers</h4>
1661+
<dt id="gap-flex"><a>flex containers</a>
1662+
<dd>
1663+
When applied to the <a>main axis</a>
1664+
(e.g. 'column-gap' in a ''flex-flow/row'' <a>flex container</a>),
1665+
indicates minimum spacing between items,
1666+
as if a fixed-size margin were inserted between adjacent <a>flex items</a>
1667+
in a single line.
16731668

1674-
The 'row-gap' and 'column-gap' properties
1675-
(and their 'gap' shorthand),
1676-
when specified on a <a>grid container</a>,
1677-
define the [=gutters=] between <a>grid rows</a> and <a>grid columns</a>.
1678-
See [[css-grid-1#gutters]] for precise details on how this works.
1669+
When applied to the <a>cross axis</a>
1670+
(e.g. 'row-gap' in a ''flex-flow/row'' <a>flex container</a>),
1671+
indicates minimum spacing between adjacent <a>flex lines</a>.
16791672

1680-
<h4 id='gap-table'>
1681-
Tables</h4>
1673+
<dt id="gap-grid"><a>grid containers</a>
1674+
<dd>
1675+
The 'row-gap' and 'column-gap' properties,
1676+
when specified on a <a>grid container</a>,
1677+
define the [=gutters=] between <a>grid rows</a> and <a>grid columns</a>,
1678+
respectively.
1679+
See [[css-grid-1#gutters]] for precise details.
1680+
</dl>
16821681

1683-
Table boxes do not use the 'gap' properties to specify separation between their cells.
1682+
Note: Table boxes do not use the 'gap' properties
1683+
to specify separation between their cells.
16841684
Instead, they use the 'border-spacing' property,
16851685
which has slightly different functionality:
16861686
it inherits,

0 commit comments

Comments
 (0)