Skip to content

Commit efdefe2

Browse files
committed
[css-align] Editorial improvements
1 parent 887d748 commit efdefe2

File tree

1 file changed

+39
-14
lines changed

1 file changed

+39
-14
lines changed

css-align/Overview.bs

Lines changed: 39 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -167,11 +167,11 @@ Overview of Alignment Properties</h2>
167167
When set on a flex container or grid container,
168168
they specify the interpretation of any ''*-self: auto'' used on the items in the container element.
169169

170-
<h2 id='alignment-values'>
171-
Alignment Values</h2>
170+
<h2 id='terms'>
171+
Alignment Terminology</h2>
172172

173-
All of the alignment properties use a common set of values,
174-
defined below.
173+
Since this module defines alignment properties for all layout modes in CSS,
174+
some abstract terminology is introduced:
175175

176176
<dl>
177177
<dt><dfn export>alignment subject</dfn>
@@ -187,6 +187,34 @@ Alignment Values</h2>
187187
The <a>alignment container</a> is the rectangle that the <a>alignment subject</a> is aligned within.
188188
This is defined by the layout mode,
189189
but is usually the <a>alignment subject</a>’s containing block.
190+
191+
<dt><dfn export>fallback alignment</dfn>
192+
<dd>
193+
Some alignments can only be fulfilled in certain situations
194+
or are limited in how much space they can consume;
195+
for example, ''space-between'' can only operate when there is more than one <a>alignment subject</a>,
196+
and baseline alignment, once fulfilled, might not be enough to absorb all the excess space.
197+
In these cases a <a>fallback alignment</a> takes effect
198+
(as defined below)
199+
to fully consume the excess space.
200+
</dl>
201+
202+
<h2 id='alignment-values'>
203+
Alignment Keywords</h2>
204+
205+
All of the alignment properties use a common set of keyword values,
206+
which are defined in this section.
207+
Keywords fall into three categories:
208+
209+
<dl>
210+
<dt><a href="#positional-values">positional alignment</a>
211+
<dd>These keywords define alignment as an absolute position within the <a>alignment container</a>.
212+
213+
<dt><a href="#baseline-values">baseline alignment</a>
214+
<dd>These keywords define alignment as a relationship among baselines within an <a>alignment context</a>.
215+
216+
<dt><a href="#distribution-values">distributed alignment</a>
217+
<dd>These keywords define alignment as a distribution of space among <a>alignment subjects</a>.
190218
</dl>
191219

192220
<h3 id='positional-values'>
@@ -260,7 +288,7 @@ Positional Alignment: the ''center'', ''start'', ''end'', ''self-start'', ''self
260288
<p class='issue'>
261289
Make it easier to understand the dual-axis nature of "start" and "end" wrt orthogonal flows.
262290

263-
<h3 id='baseline'>
291+
<h3 id='baseline-values'>
264292
Baseline Alignment: the ''baseline'' and ''last-baseline'' keywords</h3>
265293

266294
See [[css-writing-modes-3#intro-baselines]].
@@ -270,6 +298,9 @@ Baseline Alignment: the ''baseline'' and ''last-baseline'' keywords</h3>
270298
within a <a>shared alignment context</a>
271299
(such as cells within a row or column)
272300
by matching up their <a>alignment baselines</a>.
301+
If the <a>alignment subject</a>’s position is not fully determined by <a>baseline alignment</a>--
302+
or if it has no <a>natural baseline</a> in the appropriate axis--
303+
the <a>alignment subject</a> is fallback-aligned insofar as possible while preserving the <a>baseline alignment</a>.
273304

274305
The baseline alignment keywords are:
275306

@@ -290,10 +321,7 @@ Baseline Alignment: the ''baseline'' and ''last-baseline'' keywords</h3>
290321
in the <a>first baseline sets</a>
291322
of all the boxes in its <a>baseline-sharing group</a>.
292323

293-
If the <a>alignment subject</a>’s position is not fully determined by <a>baseline alignment</a>,
294-
or the box has no <a>natural baseline</a> in the appropriate axis,
295-
the content is ''start''-aligned insofar as possible while preserving the <a>baseline alignment</a>.
296-
(<a>Alignment subjects</a> that have no inline-level content are thus ''start''-aligned.)
324+
The <a>fallback alignment</a> for ''baseline'' is ''start''.
297325

298326
<dt><dfn>last-baseline</dfn>
299327
<dd>
@@ -305,10 +333,7 @@ Baseline Alignment: the ''baseline'' and ''last-baseline'' keywords</h3>
305333
in the <a>last baseline sets</a>
306334
of all the boxes in its <a>baseline-sharing group</a>.
307335

308-
If the <a>alignment subject</a>’s position is not fully determined by <a>baseline alignment</a>,
309-
or the box has no <a>natural baseline</a> in the appropriate axis,
310-
the content is ''end''-aligned insofar as possible while preserving the <a>baseline alignment</a>.
311-
(<a>Alignment subjects</a> that have no inline-level content are thus ''end''-aligned.)
336+
The <a>fallback alignment</a> for ''baseline'' is ''start''.
312337

313338
Issue: Should this ''end'' fallback be ''safe'' or ''unsafe''?
314339
</dl>
@@ -345,7 +370,7 @@ Distributed Alignment: the ''<content-distribution>/stretch'', ''space-between''
345370
to distribute the <a>alignment subjects</a>
346371
evenly between the start and end edges of the <a>alignment container</a>.
347372
When the <a>alignment subjects</a> cannot be distributed in this way,
348-
they behave as their <dfn export>fallback alignment</dfn>.
373+
they behave as their <a>fallback alignment</a>.
349374
Each distribution value has an associated <<content-position>> as a <a>fallback alignment</a>,
350375
but one can alternatively be explicitly specified in the property.
351376

0 commit comments

Comments
 (0)