Skip to content

Commit d59eeaf

Browse files
committed
[css-align] Clarify the baseline self/content-alignment paragraph to make some goddam sense.
1 parent aa03ede commit d59eeaf

1 file changed

Lines changed: 17 additions & 7 deletions

File tree

css-align/Overview.bs

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -691,13 +691,18 @@ Baseline Content-Alignment</h3>
691691
within its start-most (end-most) <a>shared alignment context</a> along that axis.
692692

693693
When a box participates in first (last) <dfn export lt="baseline content-alignment|first-baseline content-alignment|last-baseline content-alignment">baseline content-alignment</dfn>
694-
its <a>alignment subject</a> is aligned to the start (end) edge of its <a>alignment container</a>
695-
and the minimum necessary extra space is added <strong>between its start (end) edge and the <a>alignment subject</a>’s edge</strong>
696-
to match its <a>alignment baseline</a> in that axis up to that of its <a>baseline-sharing group</a>.
694+
it aligns its contents as follows:
695+
its <a>alignment subject</a> (i.e. content)
696+
is aligned to the start (end) edge of its <a>alignment container</a> (i.e. itself)
697+
and the minimum necessary extra space is added <strong>between its start (end) content edge and its <a>alignment subject</a>’s edge</strong>
698+
to align its <a>alignment baseline</a> in that axis with those of its <a>baseline-sharing group</a>.
697699
See [[#align-by-baseline]].
698700
This increases the intrinsic size of the box.
699701

700-
ISSUE: Make that last paragraph more readable.
702+
Note: In other words, a box participating in <a>baseline content-alignment</a>
703+
acts like its 'padding' was increased
704+
so that its <a>alignment baseline</a> lines up with the <a>alignment baselines</a> of its participating siblings.
705+
The box itself is aligned as usual for its 'align-self'/'justify-self' value.
701706

702707
<h3 id="overflow-scroll-position">
703708
Overflow and Scroll Positions</h3>
@@ -989,13 +994,18 @@ Baseline Self-Alignment</h3>
989994
it participates in first (last) <a>baseline self-alignment</a>
990995
within its start-most (end-most) <a>shared alignment context</a> along that axis.
991996

992-
When a box participates in first (last) <dfn export lt="baseline self-alignment|first-baseline self-alignment|last-baseline self-alignment">baseline self-alignment</dfn>
993-
its <a>alignment subject</a> is aligned to the start (end) edge of its <a>alignment container</a>
994-
and the minimum necessary extra space is added <strong>between its start (end) edge and the <a>alignment container</a> edge</strong>
997+
When a box participates in first (last) <dfn export lt="baseline self-alignment|first-baseline self-alignment|last-baseline self-alignment">baseline self-alignment</dfn>,
998+
it is aligned as follows:
999+
the minimum necessary extra space is added <strong>between its start (end) edge and the <a>alignment container</a> edge</strong>
9951000
to match its <a>alignment baseline</a> in that axis up to that of its <a>baseline-sharing group</a>.
9961001
See [[#align-by-baseline]].
9971002
This may increase the intrinsic size contribution of the <a>alignment subject</a>.
9981003

1004+
Note: In other words, a box participating in <a>baseline self-alignment</a>
1005+
acts like its 'margin' was increased
1006+
so that its <a>alignment baseline</a> lines up with the <a>alignment baselines</a> of its participating siblings.
1007+
The box's contents are aligned as usual for its 'align-content'/'justify-content' value.
1008+
9991009
<!--
10001010
████ ████████ ████████ ██ ██ ██████
10011011
██ ██ ██ ██ ██ ███ ███ ██ ██

0 commit comments

Comments
 (0)