Skip to content

Commit 5e05f52

Browse files
annevkannevk
committed
improve the xml-stylesheet text some more
1 parent 75ace9a commit 5e05f52

2 files changed

Lines changed: 48 additions & 37 deletions

File tree

‎cssom/Overview.html‎

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,10 @@
11
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
2+
<!--
3+
ISSUES
4+
- This list is not complete
5+
- The specification is pretty vague and more importantly inconsistent about
6+
liveness
7+
-->
28

39
<html lang=en-US>
410
<head>
@@ -514,16 +520,19 @@ <h4 id=ltxml-stylesheet><span class=secno>2.2.3.
514520
href="#linkstyle">LinkStyle</a></code> on objects implementing
515521
<code>ProcessingInstruction</code>.
516522

517-
<p>If the <code>href</code> pseudo-attribute of the processing instruction
518-
doesn't point to an external resource or points to an external resource
519-
that has not yet been downloaded the <code title=linkstyle-sheet><a
520-
href="#linkstyle-sheet">sheet</a></code> attribute <em class=ct>must</em>
521-
be <code>null</code>. Otherwise, if the resource has been downloaded and
522-
the determined type is a supported style sheet language the <code
523+
<p>If the <code title="">target</code> DOM attribute of the
524+
<code>ProcessingInstruction</code> is not <code>xml-stylesheet</code> or
525+
if the <code>href</code> pseudo-attribute of the processing instruction
526+
doesn't point to an external resource or does point to an external
527+
resource that has not yet been downloaded the <code
523528
title=linkstyle-sheet><a href="#linkstyle-sheet">sheet</a></code>
524-
attribute <em class=ct>must</em> be a <code><a
525-
href="#stylesheet">StyleSheet</a></code> object with the members
526-
implemented as follows:
529+
attribute <em class=ct>must</em> be <code>null</code>. Otherwise, if the
530+
<code title="">target</code> DOM attribute is <code>xml-stylesheet</code>,
531+
the resource has been downloaded and the determined type is a supported
532+
style sheet language the <code title=linkstyle-sheet><a
533+
href="#linkstyle-sheet">sheet</a></code> attribute <em class=ct>must</em>
534+
be a <code><a href="#stylesheet">StyleSheet</a></code> object with the
535+
members implemented as follows:
527536

528537
<dl>
529538
<dt><code title=stylesheet-type><a href="#stylesheet-type">type</a></code>
@@ -1393,12 +1402,11 @@ <h4 id=the-cssstylerule><span class=secno>3.4.2. </span>The <code><a
13931402
<dl class=members>
13941403
<dt><dfn id=cssstylerule-selectortext
13951404
title=cssstylerule-selectortext><code>selectorText</code></dfn> of type
1396-
<code>DOMString</code></dt>
1397-
<!-- Firefox currently doesn't allow setting of selectorText -->
1405+
<code>DOMString</code>
13981406

13991407
<dd>
14001408
<p>On setting, user agents <em class=ct>must</em> parse the given string
1401-
as a group of selectors. If the given string was ignored user agents <em
1409+
as a group of selectors. If the given string is ignored user agents <em
14021410
class=ct>must</em> act as if setting didn't occur. Otherwise, set the
14031411
attribute to the parsed string.</p>
14041412

@@ -1420,8 +1428,7 @@ <h4 id=the-csscharsetrule><span class=secno>3.4.3. </span>The <code><a
14201428

14211429
<p><code>@charset</code> can (only) be used at the very start of a <a
14221430
href="#css-style-sheet">CSS style sheet</a> to indicate the encoding of
1423-
the file ([CSS21], section 4.4).</p>
1424-
<!-- XXX: this was not readonly -->
1431+
the file ([CSS21], section 4.4).
14251432

14261433
<pre
14271434
class=idl>interface <dfn id=csscharsetrule>CSSCharsetRule</dfn> : <a href="#cssrule">CSSRule</a> {

‎cssom/Overview.src.html‎

Lines changed: 27 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,10 @@
11
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
2+
<!--
3+
ISSUES
4+
- This list is not complete
5+
- The specification is pretty vague and more importantly inconsistent about
6+
liveness
7+
-->
28
<html lang="en-US">
39
<head>
410
<title>Cascading Style Sheets Object Model (CSSOM)</title>
@@ -130,8 +136,8 @@ <h4 id="terminology">Terminology and Conventions</h4>
130136
<p>A <dfn>color component separator</dfn> is a literal U+002C COMMA followed
131137
by a U+0020 SPACE.</p>
132138

133-
<p>When this specification talks about object <code><var>A</var></code> where
134-
<code><var>A</var></code> is actually an interface, it generally means
139+
<p>When this specification talks about object <code><var>A</var></code>
140+
where <code><var>A</var></code> is actually an interface, it generally means
135141
an object implementing interface <code><var>A</var></code>.</p>
136142

137143
<!--
@@ -142,11 +148,11 @@ <h4 id="terminology">Terminology and Conventions</h4>
142148
-->
143149

144150
<p>The terms <dfn id="whitespace">whitespace</dfn> and
145-
<dfn id="style-sheet">style sheet</dfn> are used as defined in the <cite>CSS
146-
2.1 Specification</cite> [CSS21].</p>
151+
<dfn id="style-sheet">style sheet</dfn> are used as defined in the <cite>CSS
152+
2.1 Specification</cite> [CSS21].</p>
147153

148154
<p>A <dfn id="css-style-sheet">CSS style sheet</dfn> is a <span>style
149-
sheet</span> that conforms to the CSS syntax rules.</p>
155+
sheet</span> that conforms to the CSS syntax rules.</p>
150156

151157
<!-- XXX: "Cascading Style Sheet style sheet" is just a joke... -->
152158

@@ -264,14 +270,17 @@ <h4><code>&lt;?xml-stylesheet?></code> processing instruction</h4>
264270
<em class="ct">must</em> implement the <code>LinkStyle</code> on objects
265271
implementing <code>ProcessingInstruction</code>.</p>
266272

267-
<p>If the <code>href</code> pseudo-attribute of the processing instruction
268-
doesn't point to an external resource or points to an external resource that
273+
<p>If the <code title="">target</code> DOM attribute of the
274+
<code>ProcessingInstruction</code> is not <code>xml-stylesheet</code> or if
275+
the <code>href</code> pseudo-attribute of the processing instruction doesn't
276+
point to an external resource or does point to an external resource that
269277
has not yet been downloaded the <code title="linkstyle-sheet">sheet</code>
270278
attribute <em class="ct">must</em> be <code>null</code>. Otherwise, if the
271-
resource has been downloaded and the determined type is a supported style
272-
sheet language the <code title="linkstyle-sheet">sheet</code> attribute
273-
<em class="ct">must</em> be a <code>StyleSheet</code> object with the
274-
members implemented as follows:</p>
279+
<code title="">target</code> DOM attribute is <code>xml-stylesheet</code>,
280+
the resource has been downloaded and the determined type is a supported
281+
style sheet language the <code title="linkstyle-sheet">sheet</code>
282+
attribute <em class="ct">must</em> be a <code>StyleSheet</code> object with
283+
the members implemented as follows:</p>
275284

276285
<dl>
277286
<dt><code title="stylesheet-type">type</code></dt>
@@ -1056,13 +1065,12 @@ <h4>The <code>CSSStyleRule</code> Interface</h4>
10561065

10571066
<dt><dfn id="cssstylerule-selectortext" title="cssstylerule-selectortext"><code>selectorText</code></dfn>
10581067
of type <code>DOMString</code></dt>
1059-
<!-- Firefox currently doesn't allow setting of selectorText -->
10601068

10611069
<dd>
10621070
<p>On setting, user agents <em class="ct">must</em> parse the given string
1063-
as a group of selectors. If the given string was ignored user agents
1064-
<em class="ct">must</em> act as if setting didn't occur. Otherwise, set the
1065-
attribute to the parsed string.</p>
1071+
as a group of selectors. If the given string is ignored user agents
1072+
<em class="ct">must</em> act as if setting didn't occur. Otherwise, set
1073+
the attribute to the parsed string.</p>
10661074

10671075
<p>On getting, this attribute <em class="ct">must</em> return a
10681076
<span title="canon-selectors">textual representation of the group of
@@ -1082,18 +1090,15 @@ <h4>The <code>CSSCharsetRule</code> Interface</h4>
10821090
style sheet</span> to indicate the encoding of the file ([CSS21], section
10831091
4.4).</p>
10841092

1085-
<!-- XXX: this was not readonly -->
10861093
<pre class="idl">interface <dfn>CSSCharsetRule</dfn> : <span>CSSRule</span> {
10871094
readonly attribute DOMString <span>encoding</span>;
10881095
};</pre>
10891096

10901097
<dl class="members">
1091-
10921098
<dt><dfn id="csscharsetrule-encoding"><code>encoding</code></dfn> of type
1093-
<code>DOMString</code>, readonly</dt>
1099+
<code>DOMString</code>, readonly</dt>
10941100

10951101
<dd>This attribute <em class="ct">must</em> be the specified encoding.</p>
1096-
10971102
</dl>
10981103

10991104
<h4>The <code>CSSImportRule</code> Interface</h4>
@@ -1108,15 +1113,14 @@ <h4>The <code>CSSImportRule</code> Interface</h4>
11081113
};</pre>
11091114

11101115
<dl class="members">
1111-
11121116
<dt><dfn id="cssimportrule-href" title="cssimportrule-href"><code>href</code></dfn>
1113-
of type <code>DOMString</code>, readonly</dt>
1117+
of type <code>DOMString</code>, readonly</dt>
11141118

11151119
<dd>This attribute <em class="ct">must</em> be the <em>resolved</em> URI of
1116-
the style sheet to be included.</dd>
1120+
the style sheet to be included.</dd>
11171121

11181122
<dt><dfn id="cssimportrule-media" title="cssimportrule-media"><code>media</code></dfn>
1119-
of type <code>MediaList</code>, readonly</dt>
1123+
of type <code>MediaList</code>, readonly</dt>
11201124

11211125
<dd>This attribute <em class="ct">must</em> be a live <code>MediaList</code>
11221126
containing a list of media queries applicable to the imported style

0 commit comments

Comments
 (0)