8000 update <?xml-stylesheet?> requirements a bit · w3c/csswg-drafts@6546486 · GitHub
Skip to content

Commit 6546486

Browse files
annevkannevk
committed
update <?xml-stylesheet?> requirements a bit
1 parent a64eab5 commit 6546486

2 files changed

Lines changed: 19 additions & 92 deletions

File tree

‎cssom/Overview.html‎

Lines changed: 10 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -29,14 +29,14 @@
2929
<div class=head>
3030
<h1 id=cssom>Cascading Style Sheets Object Model (<abbr>CSSOM</abbr>)</h1>
3131

32-
<h2 class="no-num no-toc" id="">Editor's draft <!--W3C Working Draft--> 27
32+
<h2 class="no-num no-toc" id="">Editor's draft <!--W3C Working Draft--> 28
3333
January 2007</h2>
3434

3535
<dl>
3636
<dt>This version:
3737

3838
<dd><a
39-
href="http://www.w3.org/TR/2007/WD-cssom-20070127">http://www.w3.org/TR/2007/WD-cssom-20070127/</a>
39+
href="http://www.w3.org/TR/2007/WD-cssom-20070128">http://www.w3.org/TR/2007/WD-cssom-20070128/</a>
4040

4141
<dt>Latest version:
4242

@@ -407,34 +407,6 @@ <h4 id=dom-feature><span class=secno>1.2.2. </span>DOM feature strings</h4>
407407

408408
<h2 id=accessing><span class=secno>2. </span>Accessing style sheets through
409409
the DOM</h2>
410-
<!--
411-
<p>An <dfn>associated style sheet</dfn> is a style sheet that is explicitly
412-
linked to or embedded within a document. (For the purposes of this definition
413-
HTTP headers are part of the document.) Examples on how you can associate
414-
style sheets with documents:</p>
415-
416-
<ul>
417-
<li>The HTML <code>meta</code> element;</li>
418-
<li>The HTML <code>link</code> element;</li>
419-
<li>The HTML <code>style</code> element;</li>
420-
<li>The SVG <code>style</code> element;</li>
421-
<li>The <code>xml-stylesheet</code> processing instruction;</li>
422-
<li>The <code>Link</code> HTTP header.</li>
423-
</ul>
424-
425-
<p>The <span>style sheet set</span> that's initially rendered unless the user
426-
has selected an alternate style sheet set is called the
427-
<span>preferred style sheet set</span>. All others are called
428-
<dfn title="alternate-style-sheet-set">alternate style sheet sets</dfn>. The
429-
<dfn id="preferred-style-sheet-set">preferred style sheet set</dfn> is either
430-
the first <span>style sheet set</span> or the style sheet set determined by
431-
the last recieved <code>Default-Style</code> HTTP header.</p>
432-
433-
<!-- I mention <code>Default-Style</code> here. Should this specification
434-
define that header? It's already "defined" in HTML4, but it's very, very
435-
vague.
436-
437-
-->
438410

439411
<p>Each style sheet is represented by a <code><a
440412
href="#stylesheet">StyleSheet</a></code> object. These objects can be
@@ -495,7 +467,10 @@ <h4 id=requirements><span class=secno>2.2.1. </span>Requirements on
495467
the DOM <em class=ct>should</em> define which objects implement the
496468
<code><a href="#linkstyle">LinkStyle</a></code> interface. In addition,
497469
these specifications <em class=ct>should</em> define how these objects
498-
create a <code><a href="#stylesheet">StyleSheet</a></code> object.
470+
affect the potentially associated <code><a
471+
href="#stylesheet">StyleSheet</a></code> object (when <code
472+
title=linkstyle-sheet><a href="#linkstyle-sheet">sheet</a></code> is
473+
non-<code>null</code>).
499474

500475
<h4 id=requirements0><span class=secno>2.2.2. </span>Requirements on
501476
specific user agents</h4>
@@ -510,27 +485,17 @@ <h4 id=requirements0><span class=secno>2.2.2. </span>Requirements on
510485
<code>HTMLMetaElement</code> if the <code>Link</code> HTTP header is
511486
supported.
512487

513-
<p class=issue>Perhaps the above should be left to specifications defining
514-
those objects.
488+
<p class=issue>Perhaps the above should be left to the HTML and SVG
489+
specifications.
515490

516491
<h4 id=ltxml-stylesheet><span class=secno>2.2.3.
517492
</span><code>&lt;?xml-stylesheet?></code> processing instruction</h4>
518493

519-
<p>User agents supporting supporting <code>ProcessingInstruction</code> <em
520-
class=ct>must</em> support the <code>&lt;?xml-stylesheet?></code>
521-
processing instruction. They must also implement the <code><a
494+
<p>User agents supporting supporting <code>&lt;?xml-stylesheet?></code> <em
495+
class=ct>must</em> implement the <code><a
522496
href="#linkstyle">LinkStyle</a></code> on objects implementing
523497
<code>ProcessingInstruction</code>.
524498

525-
<div class=issue>
526-
<p>This section needs to define how to obtain pseudo-attributes from a
527-
processing instruction. How to handle error handling. For instance, the
528-
first attribute declaration wins.</p>
529-
530-
<p>This needs to be done in generic terms so other specifications can
531-
reuse it.</p>
532-
</div>
533-
534499
<h3 id=the-documentstyle><span class=secno>2.3. </span>The <code><a
535500
href="#documentstyle">DocumentStyle</a></code> Interface</h3>
536501

‎cssom/Overview.src.html‎

Lines changed: 9 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -190,35 +190,6 @@ <h4>DOM feature strings</h4>
190190

191191
<h2>Accessing style sheets through the DOM</h2>
192192

193-
<!--
194-
<p>An <dfn>associated style sheet</dfn> is a style sheet that is explicitly
195-
linked to or embedded within a document. (For the purposes of this definition
196-
HTTP headers are part of the document.) Examples on how you can associate
197-
style sheets with documents:</p>
198-
199-
<ul>
200-
<li>The HTML <code>meta</code> element;</li>
201-
<li>The HTML <code>link</code> element;</li>
202-
<li>The HTML <code>style</code> element;</li>
203-
<li>The SVG <code>style</code> element;</li>
204-
<li>The <code>xml-stylesheet</code> processing instruction;</li>
205-
<li>The <code>Link</code> HTTP header.</li>
206-
</ul>
207-
208-
<p>The <span>style sheet set</span> that's initially rendered unless the user
209-
has selected an alternate style sheet set is called the
210-
<span>preferred style sheet set</span>. All others are called
211-
<dfn title="alternate-style-sheet-set">alternate style sheet sets</dfn>. The
212-
<dfn id="preferred-style-sheet-set">preferred style sheet set</dfn> is either
213-
the first <span>style sheet set</span> or the style sheet set determined by
214-
the last recieved <code>Default-Style</code> HTTP header.</p>
215-
216-
<!-- I mention <code>Default-Style</code> here. Should this specification
217-
define that header? It's already "defined" in HTML4, but it's very, very
218-
vague.
219-
220-
-->
221-
222193
<p>Each style sheet is represented by a <code>StyleSheet</code> object. These
223194
objects can be accessed through the <code>LinkStyle</code> interface
224195
implemented on individual <code>Node</code> objects or through the
@@ -266,12 +237,13 @@ <h3>The <code>LinkStyle</code> Interface</h3>
266237
the specification the defines the semantics of said node.</p>
267238

268239
<h4>Requirements on specifications</h4>
269-
240+
270241
<p>Specifications introducing new ways of associating style sheets through
271242
the DOM <em class="ct">should</em> define which objects implement the
272243
<code>LinkStyle</code> interface. In addition, these specifications
273-
<em class="ct">should</em> define how these objects create a
274-
<code>StyleSheet</code> object.</p>
244+
<em class="ct">should</em> define how these objects affect the potentially
245+
associated <code>StyleSheet</code> object (when
246+
<code title="linkstyle-sheet">sheet</code> is non-<code>null</code>).</p>
275247

276248
<h4>Requirements on specific user agents</h4>
277249

@@ -283,24 +255,14 @@ <h4>Requirements on specific user agents</h4>
283255
<code>HTMLMetaElement</code> if the <code>Link</code> HTTP header is
284256
supported.</p>
285257

286-
<p class="issue">Perhaps the above should be left to specifications defining
287-
those objects.</p>
258+
<p class="issue">Perhaps the above should be left to the HTML and SVG
259+
specifications.</p>
288260

289261
<h4><code>&lt;?xml-stylesheet?></code> processing instruction</h4>
290262

291-
<p>User agents supporting supporting <code>ProcessingInstruction</code>
292-
<em class="ct">must</em> support the <code>&lt;?xml-stylesheet?></code>
293-
processing instruction. They must also implement the <code>LinkStyle</code> on
294-
objects implementing <code>ProcessingInstruction</code>.</p>
295-
296-
<div class="issue">
297-
<p>This section needs to define how to obtain pseudo-attributes from a
298-
processing instruction. How to handle error handling. For instance, the first
299-
attribute declaration wins.</p>
300-
301-
<p>This needs to be done in generic terms so other specifications can reuse
302-
it.</p>
303-
</div>
263+
<p>User agents supporting supporting <code>&lt;?xml-stylesheet?></code>
264+
<em class="ct">must</em> implement the <code>LinkStyle</code> on objects
265+
implementing <code>ProcessingInstruction</code>.</p>
304266

305267
<h3>The <code>DocumentStyle</code> Interface</h3>
306268

0 commit comments

Comments
 (0)