Skip to content

Commit 24b0a4d

Browse files
committed
[css-align] Rename 'true' to 'unsafe', and remove the lingering mentions of default overflow alignment in individual layout modes.
1 parent 73ae282 commit 24b0a4d

1 file changed

Lines changed: 8 additions & 19 deletions

File tree

css-align/Overview.bs

Lines changed: 8 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -382,7 +382,7 @@ Distributed Alignment: the ''<content-distribution>/stretch'', ''space-between''
382382
Add even more example images.
383383

384384
<h3 id='overflow-values'>
385-
Overflow Alignment: the ''safe'' and ''true'' keywords</h3>
385+
Overflow Alignment: the ''safe'' and ''unsafe'' keywords</h3>
386386

387387
When the <a>alignment subject</a> is larger than the <a>alignment container</a>,
388388
it will overflow.
@@ -394,34 +394,29 @@ Overflow Alignment: the ''safe'' and ''true'' keywords</h3>
394394

395395
To help combat this problem,
396396
an <dfn export>overflow alignment</dfn> mode can be explicitly specified.
397-
"True" alignment honors the specified alignment mode in overflow situations, even if it causes data loss,
397+
"Unsafe" alignment honors the specified alignment mode in overflow situations, even if it causes data loss,
398398
while "safe" alignment changes the alignment mode in overflow situations in an attempt to avoid data loss.
399399

400400
If the <a>overflow alignment</a> isn't explicitly specified,
401-
the default <a>overflow alignment</a> is ''true''.
401+
the default <a>overflow alignment</a> is ''unsafe''.
402402

403-
<pre class='prod'><dfn>&lt;overflow-position></dfn> = true | safe</pre>
403+
<pre class='prod'><dfn>&lt;overflow-position></dfn> = &lt; | safe</pre>
404404

405405
<dl dfn-type="value" dfn-for="<overflow-position>">
406406
<dt><dfn>safe</dfn>
407407
<dd>
408408
If the size of the <a>alignment subject</a> overflows the <a>alignment container</a>,
409409
the <a>alignment subject</a> is instead aligned as if the alignment mode were ''start''.
410410

411-
<dt><dfn>true</dfn>
411+
<dt><dfn>unsafe</dfn>
412412
<dd>
413413
Regardless of the relative sizes of the <a>alignment subject</a> and <a>alignment container</a>,
414414
the given alignment value is honored.
415-
416-
Issue: Calling one value "true" incorrectly makes one think of booleans.
417-
Is there a better term to use here?
418-
Or, now that ''true'' is the default,
419-
can we just drop the keyword and let it be expressed by omission?
420415
</dl>
421416

422417

423418
<div class='example'>
424-
The figure below illustrates the difference in "safe" versus "true" centering,
419+
The figure below illustrates the difference in "safe" versus "unsafe" centering,
425420
using a column flexbox as an example:
426421

427422
<figure>
@@ -463,12 +458,12 @@ Overflow Alignment: the ''safe'' and ''true'' keywords</h3>
463458
</div>
464459
<figcaption>
465460
The items in the figure on the left are set to ''align-self: safe center;'',
466-
while those in the figure on the right are set to ''align-self: true center;''.
461+
while those in the figure on the right are set to ''align-self: unsafe center;''.
467462
If this column <a>flex container</a> was placed against the left edge of the page,
468463
the "safe" behavior would be more desirable,
469464
as the long item would be fully readable.
470465
In other circumstances,
471-
the "true" centering behavior might be better,
466+
the "unsafe" centering behavior might be better,
472467
as it correctly centers all the items.
473468
</figcaption>
474469
</figure>
@@ -718,7 +713,6 @@ Inline/Main-Axis Alignment: the 'justify-self' property</h3>
718713
(Note: This is the legacy behavior of HTML <code>align</code>.)
719714
The <a>alignment subject</a> is the block's margin box.
720715

721-
The default <a>overflow alignment</a> is ''safe''.
722716
In terms of CSS2.1 block-level formatting [[!CSS21]],
723717
the rules for "over-constrained" computations in <a href="http://www.w3.org/TR/CSS21/visudet.html#blockwidth">section 10.3.3</a>
724718
are ignored in favor of alignment as specified here
@@ -749,7 +743,6 @@ Inline/Main-Axis Alignment: the 'justify-self' property</h3>
749743
as modified by the offset properties ('top'/'right'/'bottom'/'left').
750744
The <a>alignment subject</a> is the box's margin box.
751745

752-
The default <a>overflow alignment</a> is ''safe''.
753746
In terms of CSS2.1 formatting [[!CSS21]],
754747
the rules for "over-constrained" computations in <a href="http://www.w3.org/TR/CSS21/visudet.html#abs-non-replaced-width">section 10.3.7</a>
755748
are ignored in favor of alignment as specified here
@@ -773,7 +766,6 @@ Inline/Main-Axis Alignment: the 'justify-self' property</h3>
773766

774767
The <a>alignment container</a> is the <a>grid area</a>.
775768
The <a>alignment subject</a> is the <a>grid item</a>’s margin box.
776-
The default <a>overflow alignment</a> is ''true''.
777769

778770
''justify-self/normal'' behaves as ''justify-self/stretch''.
779771
</dl>
@@ -849,7 +841,6 @@ Block/Cross-Axis Alignment: the 'align-self' property</h3>
849841
as modified by the offset properties ('top'/'right'/'bottom'/'left').
850842
The <a>alignment subject</a> is the box's margin box.
851843

852-
The default <a>overflow alignment</a> is ''safe''.
853844
In terms of CSS2.1 formatting [[!CSS21]],
854845
the rules for "over-constrained" computations in <a href="http://www.w3.org/TR/CSS21/visudet.html#abs-non-replaced-height">section 10.6.4</a>
855846
are ignored in favor of alignment as specified here
@@ -870,7 +861,6 @@ Block/Cross-Axis Alignment: the 'align-self' property</h3>
870861

871862
The <a>alignment container</a> is the <a>flex line</a> the item is in.
872863
The <a>alignment subject</a> is the <a>flex item</a>’s margin box.
873-
The default <a>overflow alignment</a> is ''true''.
874864
See [[!CSS3-FLEXBOX]] for details.
875865

876866
''align-self/normal'' behaves as ''align-self/stretch''.
@@ -881,7 +871,6 @@ Block/Cross-Axis Alignment: the 'align-self' property</h3>
881871

882872
The <a>alignment container</a> is the <a>grid area</a>.
883873
The <a>alignment subject</a> is the <a>grid item</a>’s margin box.
884-
The default <a>overflow alignment</a> is ''true''.
885874

886875
''align-self/normal'' behaves as ''align-self/stretch''.
887876
</dl>

0 commit comments

Comments
 (0)