Skip to content

Commit 4838dee

Browse files
committed
[css-cascade-5][editorial] Fixed Bikeshed issues
1 parent 55d42aa commit 4838dee

File tree

1 file changed

+45
-28
lines changed

1 file changed

+45
-28
lines changed

css-cascade-5/Overview.bs

Lines changed: 45 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -28,16 +28,31 @@ Informative Classes: ex
2828
</pre>
2929

3030
<pre class=link-defaults>
31-
spec:dom; type:dfn; text:shadow tree
31+
spec:css-2025; type:dfn; text:vendor-prefixed
32+
spec:css-backgrounds-3;
33+
type:property;
34+
text:border
35+
text:border-color
36+
text:border-image
37+
text:border-style
38+
text:border-bottom-width
39+
text:border-left-width
40+
text:border-right-width
41+
text:border-top-width
42+
type:value; for:border-style; text:dotted
3243
spec:css-color-4; type:property; text:color
44+
spec:css-conditional-3; type:at-rule; text:@media
3345
spec:css-values-3; type: value; text:ex
3446
spec:css-values-5; type: function; text:if()
35-
spec:css-conditional-3; type:at-rule; text:@media
36-
spec:mediaqueries-4; type:type; for:@media; text:all
37-
spec:mediaqueries-4; type:type; text:<media-query>
38-
spec:css-2021; type:dfn; text:vendor-prefixed
39-
spec:css-fonts-4; type:property; text:font-style
40-
spec:css-fonts-4; type:property; text:font-family
47+
spec:css-fonts-4; type:property;
48+
text:font-family
49+
text:font-size-adjust
50+
text:font-style
51+
spec:dom; type:dfn; text:shadow tree
52+
spec:html; type:element; text:audio
53+
spec:mediaqueries-4; type:type;
54+
for:@media; text:all
55+
text:<media-query>
4156
</pre>
4257

4358
<pre class=ignored-specs>
@@ -51,7 +66,7 @@ Introduction</h2>
5166
CSS defines a finite set of parameters,
5267
called <dfn export for=CSS lt="property">properties</dfn>,
5368
that direct the rendering of a document.
54-
Each [=property=] has a name
69+
Each [=CSS/property=] has a name
5570
(e.g., 'color', 'font-size', or 'border-style'),
5671
a value space
5772
(e.g., <<color>>, <<length-percentage>>, <css>[ solid | dashed | dotted | &hellip; ]</css>),
@@ -237,7 +252,7 @@ Conditional ''@import'' Rules</h3>
237252

238253
The [=import conditions=] are given by
239254
<<media-query-list>>, which is parsed and interpreted as a <a>media query list</a>,
240-
and <<supports-condition>>, is parsed and interpreted as a [[supports query]].
255+
and <<supports-condition>>, is parsed and interpreted as a [=supports query=].
241256
If a <<declaration>> is given in place of a <<supports-condition>>,
242257
it must be interpreted as a <<supports-decl>>
243258
(i.e. the extra set of parentheses is implied)
@@ -845,7 +860,7 @@ Per-Fragment Value Processing</h3>
845860
Subsequent value processing proceeds as normal in each fragment.
846861

847862
APIs that assume a singular value per [=box=] (rather than per [=box fragment=])
848-
must ignore the effects of non-[=tree-abiding=] [=pseudo-elements=].
863+
must ignore the effects of non-[=tree-abiding pseudo-elements=].
849864
(For example, ''::first-line'' styles have no effect on the value returned by {{getComputedStyle()}}.)
850865

851866
<div class=example>
@@ -1058,7 +1073,7 @@ Cascade Sorting Order</h3>
10581073

10591074
<ul>
10601075
<li>Style sheets are ordered
1061-
in [[final CSS style sheets]] order.
1076+
in [=final CSS style sheets=] order.
10621077
<li>Declarations from <a at-rule lt="@import">imported style sheets</a>
10631078
are ordered as if their style sheets were substituted in place of the ''@import'' rule.
10641079
<li>Declarations from style sheets independently linked by the originating document
@@ -1341,8 +1356,8 @@ Layer Naming and Nesting</h4>
13411356

13421357
<div class="example">
13431358
In this example,
1344-
the nested ''framework.base'' layer is distinct
1345-
from the top-level ''base'' layer:
1359+
the nested <css>framework.base</css> layer is distinct
1360+
from the top-level <css>base</css> layer:
13461361

13471362
<pre class='lang-css'>
13481363
@layer base {
@@ -1362,16 +1377,16 @@ Layer Naming and Nesting</h4>
13621377

13631378
The resulting layers can be represented as a tree:
13641379

1365-
1. ''base''
1366-
2. ''framework''
1367-
1. ''base''
1368-
2. ''theme''
1380+
1. <css>base</css>
1381+
2. <css>framework</css>
1382+
1. <css>base</css>
1383+
2. <css>theme</css>
13691384

13701385
or as a flat list with nested identifiers:
13711386

1372-
1. ''base''
1373-
2. ''framework.base''
1374-
3. ''framework.theme''
1387+
1. <css>base</css>
1388+
2. <css>framework.base</css>
1389+
3. <css>framework.theme</css>
13751390
</div>
13761391

13771392
Syntactically, an explicit [=layer name=] is represented
@@ -1896,7 +1911,7 @@ Rolling Back Cascade Origins: the ''revert'' keyword</h4>
18961911
reverting one of the paired properties in a [=logical property group=]
18971912
also reverts the other one; etc.
18981913

1899-
<h4 id="revert-layer" caniuse="mdn-css_types_global_keywords_revert-layer">
1914+
<h4 id="revert-layer">
19001915
Rolling Back Cascade Layers: the ''revert-layer'' keyword</h4>
19011916

19021917
The <dfn value for=all>revert-layer</dfn> [=CSS-wide keyword=]
@@ -1985,7 +2000,6 @@ Rolling Back Rules: the ''revert-rule'' keyword</h4>
19852000
the above style sets ''border-radius'' to <code>0px</code>
19862001
only when the [=computed value=] of <code>--mode</code>
19872002
is <code>sharp</code>.
1988-
</pre>
19892003
</div>
19902004

19912005
The ''revert-rule'' keyword behaves like ''revert-layer''
@@ -2065,7 +2079,7 @@ Non-trivial changes since the <a href="CSS Cascading and Inheritance Level 5">13
20652079
* Added the ''revert-rule'' keyword.
20662080
(<a href="https://github.com/w3c/csswg-drafts/issues/10443">Issue 10443</a>)
20672081
* Clarify that all “aliases” of a property are reverted by ''revert''/''revert-layer''.
2068-
* Clarify that style sheets are ordered in [[final CSS style sheets]] order.
2082+
* Clarify that style sheets are ordered in [=final CSS style sheets=] order.
20692083
* Clarify that only ''@layer'' statement rules are ignored when checking validity of ''@import'', not empty ''@layer'' block rules.
20702084

20712085
<h3 id="changes-2021-10">
@@ -2191,8 +2205,8 @@ Additions Since Level 2</h3>
21912205
and Boris Zbarsky
21922206
contributed to this specification.
21932207

2194-
<h2 class=no-num id=priv-sec>
2195-
Privacy and Security Considerations</h2>
2208+
<h2 class=no-num id=privacy>
2209+
Privacy Considerations</h2>
21962210

21972211
* The cascade process does not distinguish between same-origin and cross-origin stylesheets,
21982212
enabling the content of cross-origin stylesheets to be inferred
@@ -2202,12 +2216,15 @@ Privacy and Security Considerations</h2>
22022216
are exposed by the cascade process,
22032217
and can be inferred from the computed styles they apply to a document.
22042218

2205-
* The ''@import'' rule does not apply the [=CORS protocol=] to loading cross-origin stylesheets,
2206-
instead allowing them to be freely imported and applied.
2207-
22082219
* The ''@import'' rule assumes that resources without <a href="https://html.spec.whatwg.org/multipage/urls-and-fetching.html#content-type"><code>Content-Type</code> metadata</a>
22092220
(or any same-origin file if the host document is in quirks mode)
22102221
are <code>text/css</code>,
22112222
potentially allowing arbitrary files to be imported into the page
22122223
and interpreted as CSS,
22132224
potentially allowing sensitive data to be inferred from the computed styles they apply to a document.
2225+
2226+
<h2 class=no-num id=security>
2227+
Security Considerations</h2>
2228+
2229+
* The ''@import'' rule does not apply the [=CORS protocol=] to loading cross-origin stylesheets,
2230+
instead allowing them to be freely imported and applied.

0 commit comments

Comments
 (0)