Skip to content

Commit 701abda

Browse files
committed
[css-cascade-3][editorial] Fixed Bikeshed issues
Note: References to CSS Fonts 3 were hardcoded, as it is not a Bikeshed spec.
1 parent 90b5aa0 commit 701abda

1 file changed

Lines changed: 37 additions & 22 deletions

File tree

css-cascade-3/Overview.bs

Lines changed: 37 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -22,15 +22,27 @@ Abstract: This CSS module describes how to collate style rules and assign values
2222
Ignored Terms: auto, flex items
2323
Include Can I Use Panels: yes
2424
Informative Classes: ex
25+
Ignore MDN Failure: default
2526
</pre>
2627

2728
<pre class=link-defaults>
28-
spec:css-values-3; type: value; text:ex
29+
spec:css-backgrounds-3; type:property;
30+
text:border
31+
text:border-bottom-width
32+
text:border-image
33+
text:border-left-width
34+
text:border-right-width
35+
text:border-style
36+
text:border-top-width
37+
spec:css-backgrounds-3; type:value; for:border-style; text:dotted
2938
spec:css-conditional-3; type:at-rule; text:@media
30-
spec:mediaqueries-4; type:type; for:@media; text:all
31-
spec:mediaqueries-4; type:type; text:<media-query>
32-
spec:css2; type:property; text:display
33-
spec:css2; type:value; text:red
39+
spec:css-values-3; type: value; text:ex
40+
spec:css2;
41+
type:property; text:display
42+
type:value; text:red
43+
spec:mediaqueries-4; type:type;
44+
for:@media; text:all
45+
text:<media-query>
3446
</pre>
3547

3648
<pre class=ignored-specs>
@@ -45,8 +57,8 @@ Introduction</h2>
4557
CSS defines a finite set of parameters,
4658
called <dfn export for=CSS lt="property">properties</dfn>,
4759
that direct the rendering of a document.
48-
Each [=property=] has a name
49-
(e.g., 'color', 'font-size', or 'border-style'),
60+
Each [=CSS/property=] has a name
61+
(e.g., 'color', <css><a href="https://www.w3.org/TR/css-fonts-3/#font-size-prop">font-size</a></css>, or 'border-style'),
5062
a value space
5163
(e.g., <<color>>, <<length-percentage>>, <css>[ solid | dashed | dotted | &hellip; ]</css>),
5264
and a defined behavior on the rendering of the document.
@@ -235,8 +247,8 @@ Shorthand Properties</h2>
235247
</div>
236248

237249
<div class='example'>
238-
For example, the CSS Level 1 'font' property
239-
is a <a>shorthand</a> property for setting <a property>font-style</a>, <a property>font-variant</a>, <a property>font-weight</a>, 'font-size', 'line-height', and <a property>font-family</a> all at once.
250+
For example, the CSS Level 1 <css><a href="https://www.w3.org/TR/css-fonts-3/#font-prop">font</a></css> property
251+
is a <a>shorthand</a> property for setting <css><a href="https://www.w3.org/TR/css-fonts-3/#font-style-prop">font-style</a></css>, <css><a href="https://www.w3.org/TR/css-fonts-3/#font-variant-prop">font-variant</a></css>, <css><a href="https://www.w3.org/TR/css-fonts-3/#font-weight-prop">font-weight</a></css>, <css><a href="https://www.w3.org/TR/css-fonts-3/#font-size-prop">font-size</a></css>, 'line-height', and <css><a href="https://www.w3.org/TR/css-fonts-3/#font-family-prop">font-family</a></css> all at once.
240252
The multiple declarations of this example:
241253

242254
<pre class='lang-css'>
@@ -254,7 +266,7 @@ Shorthand Properties</h2>
254266

255267
<pre class='lang-css'>h1 { font: bold 12pt/14pt Helvetica }</pre>
256268

257-
As more 'font' <a>sub-properties</a> are introduced into CSS,
269+
As more <css><a href="https://www.w3.org/TR/css-fonts-3/#font-prop">font</a></css> <a>sub-properties</a> are introduced into CSS,
258270
the shorthand declaration resets those to their initial values as well.
259271
</div>
260272

@@ -506,7 +518,7 @@ Actual Values</h3>
506518
<span class=ex>For example, a user agent may only be able to render borders with integer pixel widths
507519
and may therefore have to approximate the <a lt="used value">used</a> width.
508520
Also, the font size of an element may need adjustment based on the availability of fonts
509-
or the value of the 'font-size-adjust' property.</span>
521+
or the value of the <css><a href="https://www.w3.org/TR/css-fonts-3/#font-size-adjust-prop">font-size-adjust</a></css> property.</span>
510522
The <dfn export local-lt="actual">actual value</dfn> is
511523
the used value after any such adjustments have been made.
512524

@@ -582,7 +594,7 @@ Examples</h3>
582594
<td><css>outside</css>
583595
<tr>
584596
<td>(f)
585-
<th>'font-size'
597+
<th><css><a href="https://www.w3.org/TR/css-fonts-3/#font-size-prop">font-size</a></css>
586598
<td><code class="declaration">font-size: 1.2em</code>
587599
<td><css>1.2em</css>
588600
<td><css>1.2em</css>
@@ -869,13 +881,13 @@ Important Declarations: the ''!important'' annotation</h3>
869881
<th>'text-indent'
870882
<td>''1em''
871883
<tr>
872-
<th>'font-style'
873-
<td>''font-style/italic''
884+
<th><css><a href="https://www.w3.org/TR/css-fonts-3/#font-style-prop">font-style</a></css>
885+
<td><css><a href="https://www.w3.org/TR/css-fonts-3/#italic">italic</a></css>
874886
<tr>
875-
<th>'font-size'
887+
<th><css><a href="https://www.w3.org/TR/css-fonts-3/#font-size-prop">font-size</a></css>
876888
<td>''12pt''
877889
<tr>
878-
<th>'font-family'
890+
<th><css><a href="https://www.w3.org/TR/css-fonts-3/#font-family-prop">font-family</a></css>
879891
<td>''sans-serif''
880892
</table>
881893
</div>
@@ -1022,7 +1034,7 @@ Changes Since the 11 February 2021 Recommendation</h3>
10221034

10231035
<ul class=non-normative>
10241036
<li id="change-2020-properties">
1025-
Added a paragraph to the introduction to define the term [=property=].
1037+
Added a paragraph to the introduction to define the term [=CSS/property=].
10261038
(<a href="https://github.com/w3c/csswg-drafts/issues/5633">Issue 5633</a>)
10271039
</ul>
10281040

@@ -1046,8 +1058,8 @@ Additions Since Level 2</h3>
10461058
and Boris Zbarsky
10471059
contributed to this specification.
10481060

1049-
<h2 class="no-num" id="priv-sec">
1050-
Privacy and Security Considerations</h2>
1061+
<h2 class="no-num" id="privacy">
1062+
Privacy Considerations</h2>
10511063

10521064
* The cascade process does not distinguish between same-origin and cross-origin stylesheets,
10531065
enabling the content of cross-origin stylesheets to be inferred
@@ -1057,12 +1069,15 @@ Privacy and Security Considerations</h2>
10571069
are exposed by the cascade process,
10581070
and can be inferred from the computed styles they apply to a document.
10591071

1060-
* The ''@import'' rule does not apply the [=CORS protocol=] to loading cross-origin stylesheets,
1061-
instead allowing them to be freely imported and applied.
1062-
10631072
* 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>
10641073
(or any same-origin file if the host document is in quirks mode)
10651074
are <code>text/css</code>,
10661075
potentially allowing arbitrary files to be imported into the page
10671076
and interpreted as CSS,
10681077
potentially allowing sensitive data to be inferred from the computed styles they apply to a document.
1078+
1079+
<h2 class="no-num" id="security">
1080+
Security Considerations</h2>
1081+
1082+
* The ''@import'' rule does not apply the [=CORS protocol=] to loading cross-origin stylesheets,
1083+
instead allowing them to be freely imported and applied.

0 commit comments

Comments
 (0)