E844 [css-align] Editorial fixups. · simonwuelker/csswg-drafts@6d3f930 · GitHub
Skip to content

Commit 6d3f930

Browse files
tabatkinstabatkins
committed
[css-align] Editorial fixups.
1 parent 1dc5044 commit 6d3f930

1 file changed

Lines changed: 47 additions & 42 deletions

File tree

‎css-align/Overview.bs‎

Lines changed: 47 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Editor: Tab Atkins Jr., Google, http://xanthir.com/contact/
1313
Previous Version: http://www.w3.org/TR/2014/WD-css-align-3-20141218/
1414
Previous Version: http://www.w3.org/TR/2013/WD-css3-align-20130514/
1515
Previous Version: http://www.w3.org/TR/2012/WD-css3-align-20120612/
16-
Abstract: This module contains the features of <a href="http://www.w3.org/TR/CSS/">CSS</a> relating to the alignment of boxes within their containers in the various CSS box layout models: block layout, table layout, flex layout, and grid layout. (The alignment of text and inline-level content is defined in [[CSS3TEXT]] and [[CSS3LINE]].)
16+
Abstract: This module contains the features of <a href="http://www.w3.org/TR/CSS/">CSS</a> relating to the alignment of boxes within their containers in the various CSS box layout models: block layout, table layout, flex layout, and grid layout. (The alignment of text and inline-level content is defined in [[CSS-TEXT-3]] and [[CSS-INLINE-3]].)
1717
Link Defaults: selectors-3 (dfn) first formatted line, css-flexbox-1 (dfn) flex line, css-multicol-1 (dfn) multi-column element, css-fonts-3 (dfn) first available font, css21 (property) max-width/max-height/min-width/min-height, css-writing-modes-3 (dfn) dominant baseline, css-position-3 (property) left, css-cascade-3 (value) initial
1818
Ignored Terms: table cell, stretch
1919
At Risk: ''last-baseline''
@@ -31,14 +31,15 @@ Introduction</h2>
3131

3232
<em>This section is not normative.</em>
3333

34-
CSS Levels 1 and 2 allowed for the alignment of text via 'text-align' and
35-
the alignment of blocks by balancing ''margin/auto'' margins. However, except in
36-
table cells, vertical alignment was not possible. As CSS3 adds further
37-
capabilities, the ability to align boxes in various dimensions becomes more
38-
critical. This module attempts to create a cohesive and common box alignment
39-
model to share among all of CSS.
34+
CSS Levels 1 and 2 allowed for the alignment of text via 'text-align'
35+
and the alignment of blocks by balancing ''margin/auto'' margins.
36+
However, except in table cells,
37+
vertical alignment was not possible.
38+
As CSS3 adds further capabilities,
39+
the ability to align boxes in various dimensions becomes more critical.
40+
This module attempts to create a cohesive and common box alignment model to share among all of CSS.
4041

41-
Note: The alignment of text and inline-level content is defined in [[CSS3TEXT]] and [[CSS3LINE]].
42+
Note: The alignment of text and inline-level content is defined in [[CSS-TEXT-3]] and [[CSS-INLINE-3]].
4243

4344
Inspiration for this document:
4445

@@ -51,10 +52,11 @@ Introduction</h2>
5152
<h3 id="placement">
5253
Module interactions</h3>
5354

54-
This module adds some new alignment capabilities to the block layout
55-
model described in [[!CSS21]] chapters 9 and 10 and defines the interaction
56-
of these properties with the alignment of table cell content using
57-
'vertical-align', as defined in [[!CSS21]] chapter 17.
55+
This module adds some new alignment capabilities
56+
to the block layout model described in [[!CSS21]] chapters 9 and 10
57+
and defines the interaction of these properties
58+
with the alignment of table cell content using 'vertical-align',
59+
as defined in [[!CSS21]] chapter 17.
5860

5961
The interaction of these properties with
6062
Grid Layout [[!CSS3-GRID-LAYOUT]]
@@ -63,19 +65,17 @@ Module interactions</h3>
6365
The property definitions here supersede those in [[!CSS3-FLEXBOX]]
6466
(which have a smaller, earlier subset of permissible values).
6567

66-
No properties in this module apply to the <code>::first-line</code> or
67-
<code>::first-letter</code> pseudo-elements.
68+
No properties in this module apply to the <code>::first-line</code>
69+
or <code>::first-letter</code> pseudo-elements.
6870

6971
<h3 id="values">
7072
Values</h3>
7173

72-
This specification follows the
73-
<a href="http://www.w3.org/TR/CSS21/about.html#property-defs">CSS property
74-
definition conventions</a> from [[!CSS21]]. Value types not defined in
75-
this specification are defined in CSS Level 2 Revision 1 [[!CSS21]].
76-
Other CSS modules may expand the definitions of these value types: for
77-
example [[CSS3VAL]], when combined with this module, adds the
78-
''initial'' keyword as a possible property value.
74+
This specification follows the <a href="http://www.w3.org/TR/CSS21/about.html#property-defs">CSS property definition conventions</a> from [[!CSS21]].
75+
Value types not defined in this specification are defined in CSS Level 2 Revision 1 [[!CSS21]].
76+
Other CSS modules may expand the definitions of these value types:
77+
for example [[CSS3VAL]], when combined with this module,
78+
adds the ''initial'' keyword as a possible property value.
7979

8080
In addition to the property-specific values listed in their definitions,
8181
all properties defined in this specification also accept the
@@ -87,7 +87,7 @@ Values</h3>
8787
<h2 id="overview">
8888
Overview of Alignment Properties</h2>
8989

90-
The <dfn>box alignment properties</dfn> in CSS are a set of 6 properties
90+
The <dfn export>box alignment properties</dfn> in CSS are a set of 6 properties
9191
that control alignment of boxes within other boxes.
9292
They can be described along two axises:
9393

@@ -208,18 +208,18 @@ Positional Alignment: the ''center'', ''start'', ''end'', ''self-start'', ''self
208208
<dd>Centers the <a>alignment subject</a> within its <a>alignment container</a>.
209209

210210
<dt><dfn for="<self-position>, <content-position>">start</dfn> <small>(self, content)</small>
211-
<dd>Aligns the <a>alignment subject</a> to be flush with the <a>alignment container</a>’s start edge.
211+
<dd>Aligns the <a>alignment subject</a> to be flush with the <a>alignment container</a>’s start edge in the appropriate axis.
212212

213213
<dt><dfn for="<self-position>, <content-position>">end</dfn> <small>(self, content)</small>
214-
<dd>Aligns the <a>alignment subject</a> to be flush with the <a>alignment container</a>’s end edge.
214+
<dd>Aligns the <a>alignment subject</a> to be flush with the <a>alignment container</a>’s end edge in the appropriate axis.
215215

216216
<dt><dfn for="<self-position>">self-start</dfn> <small>(self)</small>
217217
<dd>Aligns the <a>alignment subject</a> to be flush with the edge of the <a>alignment container</a>
218-
corresponding to the <a>alignment subject</a>’s start side.
218+
corresponding to the <a>alignment subject</a>’s start side in the appropriate axis.
219219

220220
<dt><dfn for="<self-position>">self-end</dfn> <small>(self)</small>
221221
<dd>Aligns the <a>alignment subject</a> to be flush with the edge of the <a>alignment container</a>
222-
corresponding to the <a>alignment subject</a>’s end side.
222+
corresponding to the <a>alignment subject</a>’s end side in the appropriate axis.
223223

224224
<dt><dfn for="<self-position>, <content-position>">flex-start</dfn> <small>(self, content)</small>
225225
<dd><strong>Only used in flex layout.</strong> [[!CSS3-FLEXBOX]]
@@ -255,8 +255,10 @@ Positional Alignment: the ''center'', ''start'', ''end'', ''self-start'', ''self
255255
<h3 id='baseline'>
256256
Baseline Alignment: the ''baseline'' and ''last-baseline'' keywords</h3>
257257

258-
<dfn>Baseline alignment</dfn> is a form of positional alignment
259-
that aligns multiple <a>alignment subjects</a> within a <a>shared alignment context</a> (such as cells within a row or column)
258+
<dfn export>Baseline alignment</dfn> is a form of positional alignment
259+
that aligns multiple <a>alignment subjects</a>
260+
within a <a>shared alignment context</a>
261+
(such as cells within a row or column)
260262
by matching up their <a>alignment baselines</a>.
261263

262264
The baseline alignment keywords are:
@@ -270,8 +272,9 @@ Baseline Alignment: the ''baseline'' and ''last-baseline'' keywords</h3>
270272
<dl dfn-type=value dfn-for="justify-content, justify-self, justify-items, align-content, align-self, align-items, <baseline-position>">
271273
<dt><dfn>baseline</dfn>
272274
<dd>
273-
Indicates <dfn dfn for>first-baseline alignment</dfn>:
274-
aligns one of the box's <a>first baselines</a>
275+
Indicates <dfn dfn for export>first-baseline alignment</dfn>:
276+
aligns one of baselines in the box's <a>first baseline set</a>
277+
in the appropriate axis
275278
with the corresponding <a>first baselines</a>
276279
of all the boxes in its <a>baseline-sharing group</a>.
277280

@@ -281,8 +284,9 @@ Baseline Alignment: the ''baseline'' and ''last-baseline'' keywords</h3>
281284

282285
<dt><dfn>last-baseline</dfn>
283286
<dd>
284-
Indicates <dfn dfn for>last-baseline alignment</dfn>:
285-
aligns one of the box's <a>last baselines</a>
287+
Indicates <dfn dfn for export>last-baseline alignment</dfn>:
288+
aligns one of baselines in the box's <a>last baseline set</a>
289+
in the appropriate axis
286290
with the corresponding <a>last baselines</a>
287291
of all the boxes in its <a>baseline-sharing group</a>.
288292

@@ -291,8 +295,8 @@ Baseline Alignment: the ''baseline'' and ''last-baseline'' keywords</h3>
291295
(Content that has no <a>last baselines</a> is thus end-aligned.)
292296
</dl>
293297

294-
These values give a box a <dfn>baseline alignment preference</dfn>:
295-
either "first" or "last", respectively.
298+
These values give a box a <dfn export>baseline alignment preference</dfn>:
299+
either “first” or “last”, respectively.
296300

297301
When specified for 'align-content'/'justify-content',
298302
these values trigger <a>baseline content-alignment</a>,
@@ -1018,9 +1022,10 @@ Block/Cross-Axis Alignment: the 'align-items' property</h3>
10181022
Baseline Alignment Details</h2>
10191023

10201024
<h3 id='baseline-export'>
1021-
Determining the Baseline of a Box</h2>
1025+
Determining the Baselines of a Box</h2>
10221026

1023-
The <dfn export lt="first baselines|baselines of a box">first baselines</dfn> (and <dfn export>last baselines</dfn>) of a box
1027+
The <dfn export lt="first baseline set|first baselines|baselines of a box">first baseline set</dfn>
1028+
(and <dfn export lt="last baseline set|last baselines">last baseline set</dfn>) of a box
10241029
for a given axis
10251030
are a set of baselines (alphabetic, central, etc.)
10261031
nominally associated with the first (last) line of text within the box.
@@ -1094,11 +1099,11 @@ Determining the Baseline of a Box</h2>
10941099
See <a href="http://www.w3.org/TR/css3-grid-layout/#grid-baselines">Grid Baselines</a> in [[!CSS3-GRID-LAYOUT]].
10951100
</dl>
10961101

1097-
To <dfn local-lt=generate|generated>generate baselines</dfn> for a box from a single baseline,
1102+
To <dfn local-lt=generate|generated export>generate baselines</dfn> for a box from a single baseline,
10981103
use the baseline table from the font settings and <a>first available font</a> of that box,
10991104
and align that baseline set to the given single baseline.
11001105

1101-
To <dfn local-lt=synthesize|synthesized>synthesize baselines</dfn> from a rectangle (or two parallel lines),
1106+
To <dfn local-lt=synthesize|synthesized export>synthesize baselines</dfn> from a rectangle (or two parallel lines),
11021107
synthesize the alphabetic baseline from the lower line
11031108
and the central baseline by averaging the positions of the upper and lower lines.
11041109

@@ -1111,7 +1116,7 @@ Determining the Baseline of a Box</h2>
11111116
<h3 id='baseline-terms'>
11121117
Baseline Alignment Terminology</h3>
11131118

1114-
A <dfn>baseline-sharing group</dfn>
1119+
A <dfn export>baseline-sharing group</dfn>
11151120
is composed of boxes that participate in baseline alignment together.
11161121
This is possible only if they
11171122

@@ -1122,7 +1127,7 @@ Baseline Alignment Terminology</h3>
11221127
(in other words, the baselines that want to align are on the same side of the alignment context).
11231128
</ul>
11241129

1125-
Boxes <dfn lt="shared alignment context|alignment context">share an alignment context</dfn> along a particular axis when they are:
1130+
Boxes <dfn lt="shared alignment context|alignment context" export>share an alignment context</dfn> along a particular axis when they are:
11261131

11271132
<ul>
11281133
<li>table cells in the same row, along the table's row (inline) axis
@@ -1133,7 +1138,7 @@ Baseline Alignment Terminology</h3>
11331138
</ul>
11341139

11351140
Boxes in a <a>baseline-sharing group</a> are aligned to each other
1136-
using their <dfn>alignment baseline</dfn>.
1141+
using their <dfn export>alignment baseline</dfn>.
11371142
This is the dominant baseline associated with
11381143
the box that generates their <a>shared alignment context</a>
11391144
on the first (last, for ''last-baseline'' alignment) <a lt="first formatted line">formatted line</a>.
@@ -1158,7 +1163,7 @@ Aligning Boxes by Baseline</h3>
11581163
Unless otherwise specified (e.g. via the 'alignment-baseline' property),
11591164
the <a>alignment baseline</a> is the <a>dominant baseline</a> of the alignment context.
11601165

1161-
Position this <dfn>aligned subtree</dfn> within the alignment container
1166+
Position this <dfn export>aligned subtree</dfn> within the alignment container
11621167
according to the rules of the <a>box alignment properties</a> in effect.
11631168

11641169
<!--

0 commit comments

Comments
 (0)