Skip to content

Commit f90de9f

Browse files
fantasaifantasai
committed
[css-cascade] Add DoC
1 parent 565054f commit f90de9f

4 files changed

Lines changed: 63 additions & 7 deletions

File tree

‎css-cascade/Overview.html‎

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -171,11 +171,14 @@ <h2 class="heading settled heading" data-level=2 id=at-import><span class=secno>
171171

172172
<p>
173173
The evaluation and full syntax of the expressions after the URL
174-
is defined by the <a href=http://www.w3.org/TR/css3-mediaqueries/>Media Queries@media block with the given media query.
174+
is defined by the <a href=http://www.w3.org/TR/css3-mediaqueries/>Media Queries</a> specification <a data-biblio-type=normative data-link-type=biblio href=#mediaq title=MEDIAQ>[MEDIAQ]</a>.
175+
If the media query does not match,
176+
the rules in the imported stylesheet do not apply,
177+
exactly as if the imported stylesheet were wrapped in an <span class=css data-link-type=maybe>@media</span> block with the given media query.
175178
User agents may therefore avoid fetching a media-dependent import
176179
as long as the media query does not match.
177180

178-
</a><div class=example><a href=http://www.w3.org/TR/css3-mediaqueries/>
181+
<div class=example>
179182
<p>
180183
The following rules illustrate how <a class=css data-link-type=maybe href=#at-ruledef-import>@import</a> rules can be made media-dependent:
181184

@@ -184,7 +187,7 @@ <h2 class="heading settled heading" data-level=2 id=at-import><span class=secno>
184187
<!--
185188
-->@import url("bluish.css") projection, tv;
186189
<!--
187-
-->@import url("narrow.css") handheld and (max-width: 400px);</pre> </a></div><a href=http://www.w3.org/TR/css3-mediaqueries/>
190+
-->@import url("narrow.css") handheld and (max-width: 400px);</pre> </div>
188191

189192
<p>
190193
When the same style sheet is imported or linked to a document in multiple places,
@@ -204,9 +207,9 @@ <h2 class="heading settled heading" data-level=2 id=at-import><span class=secno>
204207
<h3 class="heading settled heading" data-level=2.1 id=content-type><span class=secno>2.1 </span><span class=content>
205208
Content-Type of CSS Style Sheets</span><a class=self-link href=#content-type>§</a></h3>
206209

207-
</a><p><a href=http://www.w3.org/TR/css3-mediaqueries/>
210+
<p>
208211
The processing of imported style sheets depends on the actual type of the linked resource.
209-
If the resource does not have </a><a href=http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.html#content-type>Content-Type metadata</a>,
212+
If the resource does not have <a href=http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.html#content-type>Content-Type metadata</a>,
210213
or the host document is in <a href=http://www.whatwg.org/specs/web-apps/current-work/multipage/infrastructure.html#quirks-mode>quirks mode</a>
211214
and has the <a href=http://www.whatwg.org/specs/web-apps/current-work/multipage/origin-0.html#same-origin>same origin</a> as the imported style sheet,
212215
the type of the linked resource is <code>text/css</code>.
@@ -1127,7 +1130,7 @@ <h2 class="no-num no-ref heading settled heading" id=references><span class=cont
11271130

11281131
<h3 class="no-num no-ref heading settled heading" id=normative><span class=content>
11291132
Normative References</span><a class=self-link href=#normative>§</a></h3>
1130-
<div data-fill-with=normative-references><dl><dt id=css3-animations title=CSS3-ANIMATIONS>[CSS3-ANIMATIONS]<dd>Dean Jackson; et al. <a href=http://www.w3.org/TR/2012/WD-css3-animations-20120403/>CSS Animations</a>. 3 April 2012. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/WD-css3-animations-20120403/>http://www.w3.org/TR/2012/WD-css3-animations-20120403/</a><dt id=css3-conditional title=CSS3-CONDITIONAL>[CSS3-CONDITIONAL]<dd>L. David Baron. <a href=http://www.w3.org/TR/2012/WD-css3-conditional-20121213/>CSS Conditional Rules Module Level 3</a>. 13 December 2012. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/WD-css3-conditional-20121213/>http://www.w3.org/TR/2012/WD-css3-conditional-20121213/</a><dt id=css3-transitions title=CSS3-TRANSITIONS>[CSS3-TRANSITIONS]<dd>Dean Jackson; et al. <a href=http://www.w3.org/TR/2012/WD-css3-transitions-20120403/>CSS Transitions</a>. 3 April 2012. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/WD-css3-transitions-20120403/>http://www.w3.org/TR/2012/WD-css3-transitions-20120403/</a><dt id=css3-writing-modes title=CSS3-WRITING-MODES>[CSS3-WRITING-MODES]<dd>Elika J. Etemad; Koji Ishii. <a href=http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/>CSS Writing Modes Module Level 3</a>. 15 November 2012. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/>http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/</a><dt id=css3val title=CSS3VAL>[CSS3VAL]<dd>Håkon Wium Lie; Tab Atkins; Elika J. Etemad. <a href=http://www.w3.org/TR/2012/CR-css3-values-20120828/>CSS Values and Units Module Level 3</a>. 28 August 2012. W3C Candidate Recommendation. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/CR-css3-values-20120828/>http://www.w3.org/TR/2012/CR-css3-values-20120828/</a><dt id=cssstyleattr title=CSSSTYLEATTR>[CSSSTYLEATTR]<dd>Tantek Çelik; Elika J. Etemad. <a href=http://www.w3.org/TR/2010/CR-css-style-attr-20101012/>CSS Style Attributes</a>. 12 October 2010. W3C Candidate Recommendation. (Work in progress.) URL: <a href=http://www.w3.org/TR/2010/CR-css-style-attr-20101012/>http://www.w3.org/TR/2010/CR-css-style-attr-20101012/</a><dt id=dom-level-2-style title=DOM-LEVEL-2-STYLE>[DOM-LEVEL-2-STYLE]<dd>Chris Wilson; Philippe Le Hégaret; Vidur Apparao. <a href=http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/>Document Object Model (DOM) Level 2 Style Specification</a>. 13 November 2000. W3C Recommendation. URL: <a href=http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/>http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/</a><dt id=rfc2119 title=RFC2119>[RFC2119]<dd>S. Bradner. <a href=http://www.ietf.org/rfc/rfc2119.txt>Key words for use in RFCs to Indicate Requirement Levels</a>. URL: <a href=http://www.ietf.org/rfc/rfc2119.txt>http://www.ietf.org/rfc/rfc2119.txt</a><dt id=select title=SELECT>[SELECT]<dd>Tantek Çelik; et al. <a href=http://www.w3.org/TR/2011/REC-css3-selectors-20110929/>Selectors Level 3</a>. 29 September 2011. W3C Recommendation. URL: <a href=http://www.w3.org/TR/2011/REC-css3-selectors-20110929/>http://www.w3.org/TR/2011/REC-css3-selectors-20110929/</a></dl></div>
1133+
<div data-fill-with=normative-references><dl><dt id=css3-animations title=CSS3-ANIMATIONS>[CSS3-ANIMATIONS]<dd>Dean Jackson; et al. <a href=http://www.w3.org/TR/2012/WD-css3-animations-20120403/>CSS Animations</a>. 3 April 2012. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/WD-css3-animations-20120403/>http://www.w3.org/TR/2012/WD-css3-animations-20120403/</a><dt id=css3-conditional title=CSS3-CONDITIONAL>[CSS3-CONDITIONAL]<dd>L. David Baron. <a href=http://www.w3.org/TR/2012/WD-css3-conditional-20121213/>CSS Conditional Rules Module Level 3</a>. 13 December 2012. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/WD-css3-conditional-20121213/>http://www.w3.org/TR/2012/WD-css3-conditional-20121213/</a><dt id=css3-transitions title=CSS3-TRANSITIONS>[CSS3-TRANSITIONS]<dd>Dean Jackson; et al. <a href=http://www.w3.org/TR/2012/WD-css3-transitions-20120403/>CSS Transitions</a>. 3 April 2012. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/WD-css3-transitions-20120403/>http://www.w3.org/TR/2012/WD-css3-transitions-20120403/</a><dt id=css3-writing-modes title=CSS3-WRITING-MODES>[CSS3-WRITING-MODES]<dd>Elika J. Etemad; Koji Ishii. <a href=http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/>CSS Writing Modes Module Level 3</a>. 15 November 2012. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/>http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/</a><dt id=css3val title=CSS3VAL>[CSS3VAL]<dd>Håkon Wium Lie; Tab Atkins; Elika J. Etemad. <a href=http://www.w3.org/TR/2012/CR-css3-values-20120828/>CSS Values and Units Module Level 3</a>. 28 August 2012. W3C Candidate Recommendation. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/CR-css3-values-20120828/>http://www.w3.org/TR/2012/CR-css3-values-20120828/</a><dt id=cssstyleattr title=CSSSTYLEATTR>[CSSSTYLEATTR]<dd>Tantek Çelik; Elika J. Etemad. <a href=http://www.w3.org/TR/2010/CR-css-style-attr-20101012/>CSS Style Attributes</a>. 12 October 2010. W3C Candidate Recommendation. (Work in progress.) URL: <a href=http://www.w3.org/TR/2010/CR-css-style-attr-20101012/>http://www.w3.org/TR/2010/CR-css-style-attr-20101012/</a><dt id=dom-level-2-style title=DOM-LEVEL-2-STYLE>[DOM-LEVEL-2-STYLE]<dd>Chris Wilson; Philippe Le Hégaret; Vidur Apparao. <a href=http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/>Document Object Model (DOM) Level 2 Style Specification</a>. 13 November 2000. W3C Recommendation. URL: <a href=http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/>http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/</a><dt id=mediaq title=MEDIAQ>[MEDIAQ]<dd>Florian Rivoal. <a href=http://www.w3.org/TR/2012/REC-css3-mediaqueries-20120619/>Media Queries</a>. 19 June 2012. W3C Recommendation. URL: <a href=http://www.w3.org/TR/2012/REC-css3-mediaqueries-20120619/>http://www.w3.org/TR/2012/REC-css3-mediaqueries-20120619/</a><dt id=rfc2119 title=RFC2119>[RFC2119]<dd>S. Bradner. <a href=http://www.ietf.org/rfc/rfc2119.txt>Key words for use in RFCs to Indicate Requirement Levels</a>. URL: <a href=http://www.ietf.org/rfc/rfc2119.txt>http://www.ietf.org/rfc/rfc2119.txt</a><dt id=select title=SELECT>[SELECT]<dd>Tantek Çelik; et al. <a href=http://www.w3.org/TR/2011/REC-css3-selectors-20110929/>Selectors Level 3</a>. 29 September 2011. W3C Recommendation. URL: <a href=http://www.w3.org/TR/2011/REC-css3-selectors-20110929/>http://www.w3.org/TR/2011/REC-css3-selectors-20110929/</a></dl></div>
11311134

11321135
<h3 class="no-num no-ref heading settled heading" id=informative><span class=content>
11331136
Informative References</span><a class=self-link href=#informative>§</a></h3>

‎css-cascade/Overview.src.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ <h2 id="at-import">
8383

8484
<p>
8585
The evaluation and full syntax of the expressions after the URL
86-
is defined by the <a href="http://www.w3.org/TR/css3-mediaqueries/">Media Queries</a. specification [[!MEDIAQ]].
86+
is defined by the <a href="http://www.w3.org/TR/css3-mediaqueries/">Media Queries</a> specification [[!MEDIAQ]].
8787
If the media query does not match,
8888
the rules in the imported stylesheet do not apply,
8989
exactly as if the imported stylesheet were wrapped in an ''@media'' block with the given media query.

‎css-cascade/issues-lc-2013.html‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
2+
<title>CSS Cascading and Inheritance Level 3 Disposition of Comments for 2013-07-30 LCWD</title>
3+
<style type="text/css">
4+
.a { background: lightgreen }
5+
.d { background: lightblue }
6+
.r { background: orange }
7+
.fo { background: red }
8+
.open { border: solid red; padding: 0.2em; }
9+
:target { box-shadow: 0.25em 0.25em 0.25em; }
10+
</style>
11+
12+
<h1>CSS Cascading and Inheritance Level 3 Disposition of Comments for 2013-07-30 LCWD</h1>
13+
14+
<p>Last call document: <a href="http://www.w3.org/TR/2013/WD-css-cascade-3-20130730/">http://www.w3.org/TR/2013/WD-css-cascade-3-20130730/</a>
15+
16+
<p>Editor's draft: <a href="http://dev.w3.org/csswg/css-cascade-3/">http://dev.w3.org/csswg/css-cascade-3/</a>
17+
18+
<p>The following color coding convention is used for comments:</p>
19+
20+
<ul>
21+
<li class="a">Accepted or Rejected and positive response
22+
<li class="r">Rejected and no response
23+
<li class="fo">Rejected and negative response
24+
<li class="d">Deferred
25+
<li class="oi">Out-of-Scope or Invalid and not verified
26+
</ul>
27+
28+
<p class=open>Open issues are marked like this</p>
29+
30+
<p>An issue can be closed as <code>Accepted</code>, <code>OutOfScope</code>,
31+
<code>Invalid</code>, <code>Rejected</code>, or <code>Retracted</code>.
32+
<code>Verified</code> indicates commentor's acceptance of the response.</p>
33+
<pre class='a' id='issue-1'>
34+
Issue 1. <a href="#issue-1">#</a>
35+
Summary: Media-dependent @import doesn't disqualify loading
36+
From: Simon Sapin
37+
Comment: <a href="http://lists.w3.org/Archives/Public/www-style/2013Jul/0634.html">http://lists.w3.org/Archives/Public/www-style/2013Jul/0634.html</a>
38+
Response: <a href="http://lists.w3.org/Archives/Public/www-style/2013Aug/0196.html">http://lists.w3.org/Archives/Public/www-style/2013Aug/0196.html</a>
39+
Closed: Accepted
40+
Verified:
41+
</pre>

‎css-cascade/issues-lc-2013.txt‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
Draft: http://www.w3.org/TR/2013/WD-css-cascade-3-20130730/
2+
Title: CSS Cascading and Inheritance Level 3
3+
4+
----
5+
Issue 1.
6+
Summary: Media-dependent @import doesn't disqualify loading
7+
From: Simon Sapin
8+
Comment: http://lists.w3.org/Archives/Public/www-style/2013Jul/0634.html
9+
Response: http://lists.w3.org/Archives/Public/www-style/2013Aug/0196.html
10+
Closed: Accepted
11+
Verified:
12+
----

0 commit comments

Comments
 (0)