Skip to content

Commit 1f2cb52

Browse files
authored
[css-anchor-position-1] Rename position-try-options to -fallbacks (#10517)
Resolves #10395.
1 parent 07003c5 commit 1f2cb52

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

css-anchor-position-1/Overview.bs

+13-13
Original file line numberDiff line numberDiff line change
@@ -1360,7 +1360,7 @@ might result in the positioned element overflowing its [=containing block=]
13601360
or being positioned partially off screen.
13611361

13621362
To ameliorate this, an [=absolutely positioned=] element
1363-
can use the 'position-try-options' property
1363+
can use the 'position-try-fallbacks' property
13641364
to refer to several variant sets of positioning/alignment properties
13651365
(generated from the element's existing styles,
13661366
or specified in ''@position-try'' rules)
@@ -1375,11 +1375,11 @@ to additional be sorted by the available space they define,
13751375
if it's more important for the element to have as much space as possible
13761376
rather than strictly follow some declared order.
13771377

1378-
Giving Fallback Options: the 'position-try-options' property {#position-try-options}
1378+
Giving Fallback Options: the 'position-try-fallbacks' property {#position-try-fallbacks}
13791379
--------------------------------
13801380

13811381
<pre class=propdef>
1382-
Name: position-try-options
1382+
Name: position-try-fallbacks
13831383
Value: none | [ [<<dashed-ident>> || <<try-tactic>>] | <<'inset-area'>> ]#
13841384
Initial: none
13851385
Inherited: no
@@ -1399,7 +1399,7 @@ or a <<try-tactic>> representing an automatic transformation of the element's ex
13991399

14001400
Values have the following meanings:
14011401

1402-
<dl dfn-type=value dfn-for=position-try-options>
1402+
<dl dfn-type=value dfn-for=position-try-fallbacks>
14031403
: <dfn>none</dfn>
14041404
::
14051405
The property has no effect;
@@ -1614,7 +1614,7 @@ the [=position options list=] will be tried.
16141614
: <dfn>normal</dfn>
16151615
::
16161616
Try the [=position options=]
1617-
in the order specified by 'position-try-options'.
1617+
in the order specified by 'position-try-fallbacks'.
16181618

16191619
: <dfn>most-width</dfn>
16201620
: <dfn>most-height</dfn>
@@ -1646,7 +1646,7 @@ the [=position options list=] will be tried.
16461646
top: anchor(bottom);
16471647
left: anchor(left);
16481648
align-self: start;
1649-
position-try-options: --bottom-scrollable, flip-block, --top-scrollable;
1649+
position-try-fallbacks: --bottom-scrollable, flip-block, --top-scrollable;
16501650
position-try-order: most-height;
16511651
}
16521652
@position-try --bottom-scrollable {
@@ -1734,10 +1734,10 @@ The 'position-try' Shorthand {#position-try-prop}
17341734

17351735
<pre class="propdef shorthand">
17361736
Name: position-try
1737-
Value: <<'position-try-order'>>? <<'position-try-options'>>
1737+
Value: <<'position-try-order'>>? <<'position-try-fallbacks'>>
17381738
</pre>
17391739

1740-
This shorthand sets both 'position-try-options' and 'position-try-order'.
1740+
This shorthand sets both 'position-try-fallbacks' and 'position-try-order'.
17411741
If <<'position-try-order'>> is omitted,
17421742
it's set to the property's initial value.
17431743

@@ -1761,7 +1761,7 @@ defines a <dfn>position option</dfn>
17611761
with a given name,
17621762
specifying one or more sets of positioning properties
17631763
that will be applied to an element
1764-
via 'position-try-options',
1764+
via 'position-try-fallbacks',
17651765

17661766
The syntax of the ''@position-try'' rule is:
17671767

@@ -1825,7 +1825,7 @@ Note: The most common types of fallback positioning
18251825
(putting the positioned element on one side of the anchor normally,
18261826
but flipping to the opposite side if needed)
18271827
can be done automatically
1828-
with keywords in 'position-try-options',
1828+
with keywords in 'position-try-fallbacks',
18291829
without using ''@position-try'' at all.
18301830

18311831

@@ -1958,8 +1958,8 @@ laying out later elements cannot change this decision.
19581958
remove its [=last successful position option=]:
19591959

19601960
* |el| is not an [=absolutely positioned=] element
1961-
* |el|'s computed value for 'position-try-options' has changed
1962-
* Any of the ''@position-try'' rules referenced by |el|'s 'position-try-options'
1961+
* |el|'s computed value for 'position-try-fallbacks' has changed
1962+
* Any of the ''@position-try'' rules referenced by |el|'s 'position-try-fallbacks'
19631963
have been added, removed, or mutated.
19641964

19651965
Then, [=determine the position fallback styles=] of |el|
@@ -1989,7 +1989,7 @@ This limit must be <em>at least</em> five.
19891989
position: fixed;
19901990
top: anchor(--button bottom);
19911991
left: anchor(--button left);
1992-
position-try-options: flip-inline, flip-block, flip-block flip-inline;
1992+
position-try-fallbacks: flip-inline, flip-block, flip-block flip-inline;
19931993

19941994
/* The popover is at least as wide as the button */
19951995
min-width: anchor-size(--button width);

0 commit comments

Comments
 (0)