Skip to content

Commit ae17552

Browse files
committed
[css-anchor-position-1] Make it clearer that base styles are part of the position options list #13268
1 parent 6954869 commit ae17552

1 file changed

Lines changed: 25 additions & 24 deletions

File tree

css-anchor-position-1/Overview.bs

Lines changed: 25 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1503,12 +1503,12 @@ or being positioned partially off screen.
15031503

15041504
To ameliorate this, an [=absolutely positioned=] box
15051505
can use the 'position-try-fallbacks' property
1506-
to specify additional [=position options=]
1506+
to specify additional <dfn>position options</dfn>
15071507
(variant sets of positioning/alignment properties
15081508
generated from the box's existing styles,
15091509
or specified in ''@position-try'' rules)
15101510
that the UA can try if the box overflows its initial position.
1511-
Each is applied to the box,
1511+
Each [=position option=] is applied to the box,
15121512
one by one in the order specified by 'position-try-order',
15131513
and the first that doesn't cause the box
15141514
to overflow its [=containing block=]
@@ -1562,25 +1562,27 @@ Applies to: [=absolutely positioned boxes=]
15621562
Animation type: discrete
15631563
</pre>
15641564

1565-
This property provides a list of alternate positioning styles
1566-
to try when the [=absolutely positioned box=]
1567-
overflows its [=inset-modified containing block=].
1568-
This <dfn export>position options list</dfn>
1569-
initially contains a single [=position option=]
1570-
generated from the element's <dfn export local-lt="base style">fallback base styles</dfn>,
1571-
i.e. the [=computed values|computed styles=] without applying 'position-try-fallbacks'.
1565+
This property provides a list of additional, alternative [=position options=]
1566+
to try in order to prevent the [=absolutely positioned box=]
1567+
from overflowing its [=inset-modified containing block=].
15721568

1573-
Each comma-separated entry in the list is a separate option:
1569+
Each comma-separated entry in the list is a separate [=position option=]:
15741570
either the name of a ''@position-try'' block,
1575-
or a <<try-tactic>> representing an automatic transformation of the box's existing computed style.
1571+
or a <<try-tactic>> representing an automatic transformation
1572+
of the box's existing computed style (its <dfn export local-lt="base style">fallback base styles</dfn>).
1573+
Together with the [=fallback base styles=],
1574+
these options form the <dfn export>position options list</dfn>
1575+
from which the effective style is chosen,
1576+
see [[#fallback-apply]].
15761577

15771578
Values have the following meanings:
15781579

15791580
<dl dfn-type=value dfn-for=position-try-fallbacks>
15801581
: <dfn>none</dfn>
15811582
::
15821583
The property has no effect;
1583-
the box's [=position options list=] is empty.
1584+
the box's [=position options list=]
1585+
consists only of the [=fallback base styles=].
15841586

15851587
: <dfn><<dashed-ident>></dfn>
15861588
::
@@ -1596,8 +1598,8 @@ Values have the following meanings:
15961598
::
15971599
Automatically creates a [=position option=]
15981600
by [=executing a try-tactic|executing the specified try tactic=]
1599-
to the box's [=base styles=],
1600-
then adding the constructed [=position option=]
1601+
on the box's [=base styles=],
1602+
then adding this constructed [=position option=]
16011603
to the box's [=position options list=].
16021604

16031605
<pre class=prod>
@@ -1684,10 +1686,10 @@ Inherited: no
16841686
Animation Type: discrete
16851687
</pre>
16861688

1687-
This property allows an element to sort its [=position options=]
1688-
by the available space they define,
1689-
if it's more important for the box to have as much space as possible
1690-
rather than strictly following the order declared in 'position-try-fallbacks'.
1689+
This property allows an element to sort its [=position option list=]
1690+
by the available space they produce.
1691+
This allows the box to prioritize having more layout space
1692+
over strictly following the order declared in 'position-try-fallbacks'.
16911693

16921694
<pre class=prod>
16931695
<dfn type><<try-size>></dfn> = most-width | most-height | most-block-size | most-inline-size
@@ -1845,11 +1847,10 @@ The ''@position-try'' Rule {#fallback-rule}
18451847
-------------------------------
18461848

18471849
The <dfn>@position-try</dfn> rule
1848-
defines a <dfn>position option</dfn>
1849-
with a given name,
1850+
defines a [=position option=] with a given name,
18501851
specifying one or more sets of positioning properties
18511852
that can be applied to a box
1852-
via 'position-try-fallbacks',
1853+
via 'position-try-fallbacks'.
18531854

18541855
The syntax of the ''@position-try'' rule is:
18551856

@@ -1862,10 +1863,10 @@ The syntax of the ''@position-try'' rule is:
18621863
The <<dashed-ident>> specified in the prelude
18631864
is the rule's name.
18641865
If multiple ''@position-try'' rules are declared with the same name,
1865-
they [=cascade=] the same as ''@keyframe'' rules do.
1866+
they [=cascade=] (overriding each other) the same as ''@keyframes'' rules do.
18661867

1867-
The ''@position-try'' rule only <dfn export lt="accepted @position-try properties">accepts</dfn>
1868-
the following [=properties=]:
1868+
The ''@position-try'' rule only accepts
1869+
the following <dfn export>accepted @position-try properties</dfn>:
18691870

18701871
* [=inset properties=]
18711872
* [=margin properties=]

0 commit comments

Comments
 (0)