[cssom] Specify what to do for dynamic changes to xml-stylesheet PIs

--HG--
extra : rebase_source : 757bd2b981c8dc20218a47129fa9a567ccbb0863

Author: Simon Pieters

cssom/Overview.html

@@ -159,7 +159,7 @@ <h2 class="no-num no-toc" id="toc">Table of Contents</h2>
     <ol>
      <li><a href="#the-linkstyle-interface"><span class="secno">6.3.1 </span>The <code title="">LinkStyle</code> Interface</a></li>
      <li><a href="#requirements-on-specifications"><span class="secno">6.3.2 </span>Requirements on specifications</a></li>
-     <li><a href="#requirements-on-user-agents-implementing-the-xml-stylesheet-processing-instruction"><span class="secno">6.3.3 </span>Requirements on User Agents Implementing the <code title="">xml-stylesheet</code> processing instruction</a></li>
+     <li><a href="#requirements-on-user-agents-implementing-the-xml-stylesheet-processing-instruction"><span class="secno">6.3.3 </span>Requirements on User Agents Implementing the xml-stylesheet processing instruction</a></li>
      <li><a href="#requirements-on-user-agents-implementing-the-http-link-header"><span class="secno">6.3.4 </span>Requirements on User Agents Implementing the HTTP
 <code title="">Link</code> Header</a></ol></li>
    <li><a href="#css-rules"><span class="secno">6.4 </span>CSS Rules</a>
@@ -1059,6 +1059,18 @@ <h3 id="css-style-sheet-collections"><span class="secno">6.2 </span>CSS Style Sh
  <li><p>Set the <a href="#concept-css-style-sheet-disabled-flag" title="concept-css-style-sheet-disabled-flag">disabled flag</a>.</li>
 </ol>
 
+<p>To <dfn id="remove-a-css-style-sheet">remove a CSS style sheet</dfn>, run these steps:</p>
+
+<ol>
+ <li><p>Remove the <a href="#css-style-sheet">CSS style sheet</a> from the list of <a href="#document-css-style-sheets">document CSS style sheets</a>.
+ 
+ <li><p>Set the <a href="#css-style-sheet">CSS style sheet</a>'s <a href="#concept-css-style-sheet-owner-node" title="concept-css-style-sheet-owner-node">owner node</a> to null.
+ 
+ <!-- "associated CSS style sheet" is defined in terms of owner node, so we don't need to set it to null explicitly -->
+ 
+ <!-- XXX does anything need to happen wrt alternate style sheets? what if the last style sheet with the preferred style sheet set name is removed? -->
+</ol>
+
 <p>A <dfn id="persistent-css-style-sheet">persistent CSS style sheet</dfn> is a
 <a href="#css-style-sheet">CSS style sheet</a> from the <a href="#document-css-style-sheets">document CSS style sheets</a>
 whose <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> is the empty string and whose
@@ -1476,21 +1488,32 @@ <h4 id="requirements-on-specifications"><span class="secno">6.3.2 </span>Require
 
 
 
-<h4 id="requirements-on-user-agents-implementing-the-xml-stylesheet-processing-instruction"><span class="secno">6.3.3 </span>Requirements on User Agents Implementing the <code title="">xml-stylesheet</code> processing instruction</h4>
+<h4 id="requirements-on-user-agents-implementing-the-xml-stylesheet-processing-instruction"><span class="secno">6.3.3 </span>Requirements on User Agents Implementing the xml-stylesheet processing instruction</h4>
 
-<!-- XXX load/error events, reparse -->
+<!-- XXX load/error events -->
 
 <pre class="idl"><a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#processinginstruction">ProcessingInstruction</a> implements <a href="#linkstyle">LinkStyle</a>;</pre>
 
-<p>For each
-<a class="external" data-anolis-spec="xmlss" href="http://www.w3.org/TR/xml-stylesheet/#dt-xml-stylesheet"><code title="">xml-stylesheet</code> processing instruction</a>
-that is not part of the
-<a class="external" data-anolis-spec="xml" href="http://www.w3.org/TR/xml/#dt-doctype">document type declaration</a> and has an
-<code title="">href</code>
-<a class="external" data-anolis-spec="xmlss" href="http://www.w3.org/TR/xml-stylesheet/#dt-pseudo-attribute">pseudo-attribute</a> these steps must
-(unless otherwise stated) be run:</p>
+<p>The <dfn id="prolog">prolog</dfn> refers to <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#concept-node" title="concept-node">nodes</a> that are children of the
+<a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#concept-document" title="concept-document">document</a> and are not <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#concept-tree-following" title="concept-tree-following">following</a> the
+<code class="external" data-anolis-spec="dom"><a href="http://dom.spec.whatwg.org/#element">Element</a></code> child of the <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#concept-document" title="concept-document">document</a>, if any.
+
+<p>When a <code class="external" data-anolis-spec="dom"><a href="http://dom.spec.whatwg.org/#processinginstruction">ProcessingInstruction</a></code> <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#concept-node" title="concept-node">node</a> <var>node</var> is inserted to a
+document, removed from a document, becomes part of the <a href="#prolog">prolog</a>, is no longer part of the <a href="#prolog">prolog</a>, or has its
+<a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#concept-cd-data" title="concept-cd-data">data</a> changed, these steps must be run:
 
 <ol>
+ <li><p>If an instance of this algorithm is currently running for <var>node</var>, abort that instance, and stop the associated
+ <a class="external" data-anolis-spec="fetch" href="http://fetch.spec.whatwg.org/#concept-fetch" title="concept-fetch">fetching</a> if applicable.
+
+ <li><p>If <var>node</var> has an <a href="#associated-css-style-sheet">associated CSS style sheet</a>, <a href="#remove-a-css-style-sheet" title="remove a CSS style sheet">remove</a> it.
+ 
+ <li><p>If <var>node</var> is not an <a class="external" data-anolis-spec="xmlss" href="http://www.w3.org/TR/xml-stylesheet/#dt-xml-stylesheet">xml-stylesheet processing instruction</a>, terminate these steps.
+ 
+ <li><p>If <var>node</var> is part of the <a class="external" data-anolis-spec="xml" href="http://www.w3.org/TR/xml/#dt-doctype">document type declaration</a>, terminate these steps.
+ 
+ <li><p>If <var>node</var> does not have an <code title="">href</code> <a class="external" data-anolis-spec="xmlss" href="http://www.w3.org/TR/xml-stylesheet/#dt-pseudo-attribute">pseudo-attribute</a>, terminate these steps.
+
  <li><p>Let <var>title</var> be the value of the
  <code title="">title</code> <a class="external" data-anolis-spec="xmlss" href="http://www.w3.org/TR/xml-stylesheet/#dt-pseudo-attribute">pseudo-attribute</a> or the empty string if the
  <code title="">title</code> <a class="external" data-anolis-spec="xmlss" href="http://www.w3.org/TR/xml-stylesheet/#dt-pseudo-attribute">pseudo-attribute</a> is not specified.</li>
@@ -1573,8 +1596,6 @@ <h4 id="requirements-on-user-agents-implementing-the-xml-stylesheet-processing-i
 </ol>
 
 
-
-
 <h4 id="requirements-on-user-agents-implementing-the-http-link-header"><span class="secno">6.3.4 </span>Requirements on User Agents Implementing the HTTP
 <code title="">Link</code> Header</h4>
 

cssom/Overview.src.html

@@ -982,6 +982,18 @@ <h3>CSS Style Sheet Collections</h3>
  <li><p>Set the <span title=concept-css-style-sheet-disabled-flag>disabled flag</span>.</li>
 </ol>
 
+<p>To <dfn>remove a CSS style sheet</dfn>, run these steps:</p>
+
+<ol>
+ <li><p>Remove the <span>CSS style sheet</span> from the list of <span>document CSS style sheets</span>.
+ 
+ <li><p>Set the <span>CSS style sheet</span>'s <span title=concept-css-style-sheet-owner-node>owner node</span> to null.
+ 
+ <!-- "associated CSS style sheet" is defined in terms of owner node, so we don't need to set it to null explicitly -->
+ 
+ <!-- XXX does anything need to happen wrt alternate style sheets? what if the last style sheet with the preferred style sheet set name is removed? -->
+</ol>
+
 <p>A <dfn>persistent CSS style sheet</dfn> is a
 <span>CSS style sheet</span> from the <span>document CSS style sheets</span>
 whose <span title=concept-css-style-sheet-title>title</span> is the empty string and whose
@@ -1399,21 +1411,32 @@ <h4>Requirements on specifications</h4>
 
 
 
-<h4>Requirements on User Agents Implementing the <code title>xml-stylesheet</code> processing instruction</h4>
+<h4>Requirements on User Agents Implementing the xml-stylesheet processing instruction</h4>
 
-<!-- XXX load/error events, reparse -->
+<!-- XXX load/error events -->
 
 <pre class="idl"><span data-anolis-spec=dom>ProcessingInstruction</span> implements <span>LinkStyle</span>;</pre>
 
-<p>For each
-<span data-anolis-spec=xmlss><code title>xml-stylesheet</code> processing instruction</span>
-that is not part of the
-<span data-anolis-spec=xml>document type declaration</span> and has an
-<code title>href</code>
-<span data-anolis-spec=xmlss>pseudo-attribute</span> these steps must
-(unless otherwise stated) be run:</p>
+<p>The <dfn>prolog</dfn> refers to <span data-anolis-spec=dom title=concept-node>nodes</span> that are children of the
+<span data-anolis-spec=dom title=concept-document>document</span> and are not <span data-anolis-spec=dom title=concept-tree-following>following</span> the
+<code data-anolis-spec=dom>Element</code> child of the <span data-anolis-spec=dom title=concept-document>document</span>, if any.
+
+<p>When a <code data-anolis-spec=dom>ProcessingInstruction</code> <span data-anolis-spec=dom title=concept-node>node</span> <var>node</var> is inserted to a
+document, removed from a document, becomes part of the <span>prolog</span>, is no longer part of the <span>prolog</span>, or has its
+<span data-anolis-spec=dom title=concept-cd-data>data</span> changed, these steps must be run:
 
 <ol>
+ <li><p>If an instance of this algorithm is currently running for <var>node</var>, abort that instance, and stop the associated
+ <span data-anolis-spec=fetch title=concept-fetch>fetching</span> if applicable.
+
+ <li><p>If <var>node</var> has an <span>associated CSS style sheet</span>, <span title="remove a CSS style sheet">remove</span> it.
+ 
+ <li><p>If <var>node</var> is not an <span data-anolis-spec=xmlss>xml-stylesheet processing instruction</span>, terminate these steps.
+ 
+ <li><p>If <var>node</var> is part of the <span data-anolis-spec=xml>document type declaration</span>, terminate these steps.
+ 
+ <li><p>If <var>node</var> does not have an <code title>href</code> <span data-anolis-spec=xmlss>pseudo-attribute</span>, terminate these steps.
+
  <li><p>Let <var>title</var> be the value of the
  <code title>title</code> <span data-anolis-spec=xmlss>pseudo-attribute</span> or the empty string if the
  <code title>title</code> <span data-anolis-spec=xmlss>pseudo-attribute</span> is not specified.</p></li>
@@ -1496,8 +1519,6 @@ <h4>Requirements on User Agents Implementing the <code title>xml-stylesheet</cod
 </ol>
 
 
-
-
 <h4>Requirements on User Agents Implementing the HTTP
 <code title>Link</code> Header</h4>