Skip to content

Commit d5516fa

Browse files
committed
[css-values-5] Per WG resolution, replace 'match-element' with 'element-shared'. #11742
1 parent ec194d0 commit d5516fa

File tree

1 file changed

+19
-19
lines changed

1 file changed

+19
-19
lines changed

css-values-5/Overview.bs

+19-19
Original file line numberDiff line numberDiff line change
@@ -2087,7 +2087,7 @@ Generating a Random Numeric Value: the ''random()'' function</h3>
20872087
<pre class=prod>
20882088
&lt;random()> = random( <<random-value-sharing>>? , <<calc-sum>>, <<calc-sum>>, <<calc-sum>>? )
20892089
2090-
<dfn><<random-value-sharing>></dfn> = [ [ auto | <<dashed-ident>> ] || match-element ]
2090+
<dfn><<random-value-sharing>></dfn> = [ [ auto | <<dashed-ident>> ] || element-shared ]
20912091
| fixed <<number [0,1]>>
20922092
</pre>
20932093

@@ -2181,7 +2181,7 @@ Generating a Random Numeric Value: the ''random()'' function</h3>
21812181
via the ''random()/auto'' or ''random()/<dashed-ident>'' values
21822182
* between [=random functions=] used for the same thing
21832183
in the styles across several elements,
2184-
via the ''random()/match-element'' value (or its absence)
2184+
via the ''random()/element-shared'' value (or its absence)
21852185

21862186
<dl dfn-type=value dfn-for="random(),<random-value-sharing>">
21872187
: <dfn>auto</dfn>
@@ -2199,8 +2199,8 @@ Generating a Random Numeric Value: the ''random()'' function</h3>
21992199
ones with different <<dashed-ident>>s
22002200
will use distinct [=random base values=].
22012201

2202-
: <dfn>match-element</dfn>
2203-
:: If ''random()/match-element'' is omitted,
2202+
: <dfn>element-shared</dfn>
2203+
:: If ''random()/element-shared'' is omitted,
22042204
[=random functions=] on different elements
22052205
will use distinct [=random base values=].
22062206

@@ -2264,8 +2264,8 @@ Generating a Random Numeric Value: the ''random()'' function</h3>
22642264

22652265
<pre highlight=css>
22662266
.shared-random-rect {
2267-
width: random(match-element, 100px, 200px);
2268-
height: random(match-element, 100px, 200px);
2267+
width: random(element-shared, 100px, 200px);
2268+
height: random(element-shared, 100px, 200px);
22692269
}
22702270
</pre>
22712271

@@ -2276,8 +2276,8 @@ Generating a Random Numeric Value: the ''random()'' function</h3>
22762276

22772277
<pre highlight=css>
22782278
.shared-random-squares {
2279-
width: random(--foo match-element, 100px, 200px);
2280-
height: random(--foo match-element, 100px, 200px);
2279+
width: random(--foo element-shared, 100px, 200px);
2280+
height: random(--foo element-shared, 100px, 200px);
22812281
}
22822282
</pre>
22832283
</div>
@@ -2296,7 +2296,7 @@ Generating a Random Numeric Value: the ''random()'' function</h3>
22962296
This ensures that every auto-generated name on a single element is unique,
22972297
and thus will get their own [=random base value=].
22982298
It also ensures that declarations like
2299-
''.foo { width: random(match-element, 100px, 200px); }''
2299+
''.foo { width: random(element-shared, 100px, 200px); }''
23002300
will cause all the ''.foo'' elements to share a [=random base value=] for their width
23012301
(they all have the same auto-generated name, "width 0").
23022302

@@ -2305,10 +2305,10 @@ Generating a Random Numeric Value: the ''random()'' function</h3>
23052305

23062306
<pre highlight=css>
23072307
.foo {
2308-
width: random(match-element, 100px, 200px);
2308+
width: random(element-shared, 100px, 200px);
23092309
}
23102310
.bar {
2311-
width: random(match-element, 200px, 300px);
2311+
width: random(element-shared, 200px, 300px);
23122312
}
23132313
</pre>
23142314

@@ -2351,8 +2351,8 @@ Generating a Random Numeric Value: the ''random()'' function</h3>
23512351
so we must treat all elements as potentially related for this purpose.
23522352
If this is undesirable,
23532353
you can always supply a sufficiently unique <<dashed-ident>> yourself,
2354-
like ''random(--sidebar-width match-element, ...)'' on one set of elements
2355-
and ''random(--card-width match-element, ...)'' on another,
2354+
like ''random(--sidebar-width element-shared, ...)'' on one set of elements
2355+
and ''random(--card-width element-shared, ...)'' on another,
23562356
or ''random(--flicker, ...)'' and ''random(--glow, ...)'' on the different rules.
23572357

23582358
This is the one case where supplying a <<dashed-ident>>
@@ -2653,7 +2653,7 @@ Caching Random Values: the <<random-value-sharing>> value</h3>
26532653
among other [=random functions=] in the same property value.
26542654

26552655
2. An element ID identifying the element the style is being applied to,
2656-
or null if ''random()/match-element'' is specified in <<random-value-sharing>>.
2656+
or null if ''random()/element-shared'' is specified in <<random-value-sharing>>.
26572657
3. A document ID identifying the {{Document}} the styles are from.
26582658

26592659
The "element ID" and "document ID" must have the same lifetimes and equivalence
@@ -2672,8 +2672,8 @@ Caching Random Values: the <<random-value-sharing>> value</h3>
26722672

26732673
<pre highlight=css>
26742674
.random-square {
2675-
width: random(--foo match-element, 100px, 500px);
2676-
height: random(--foo match-element, 100px, 500px);
2675+
width: random(--foo element-shared, 100px, 500px);
2676+
height: random(--foo element-shared, 100px, 500px);
26772677
}
26782678
</pre>
26792679

@@ -2684,7 +2684,7 @@ Caching Random Values: the <<random-value-sharing>> value</h3>
26842684
with a size somewhere between ''100px'' and ''500px''.
26852685
Additionally, <em>every</em> ''.random-square'' element on the page
26862686
will have the same size,
2687-
since ''match-element'' was specified.
2687+
since ''element-shared'' was specified.
26882688
In fact, completely unrelated styles using the same ''random()'' function
26892689
will also end up sharing that value.
26902690

@@ -2770,8 +2770,8 @@ Caching Random Values: the <<random-value-sharing>> value</h3>
27702770
and this ends up defining a random <em>rectangle</em>,
27712771
rather than a square.
27722772

2773-
Similarly, a ''match-element'' in the <<random-value-sharing>>
2774-
won't determine its "element identifier"
2773+
Similarly, a lack of ''random()/element-shared'' in the <<random-value-sharing>>
2774+
won't cause the function to determine its "element identifier"
27752775
until substitution actually happens,
27762776
which might be <em>after</em> '--size' has inherited through multiple elements,
27772777
so again multiple elements using ''var(--size)''

0 commit comments

Comments
 (0)