- From: poot <cvsmail@w3.org>
- Date: Wed, 29 Feb 2012 16:25:11 -0500
- To: public-html-diffs@w3.org
hixie: Add support for MutationObservers. (Also, add a minor internal note in the canvas section unrelated to this.) (Also, automated update of the CLDR which resulted in removing separate support for el-POLYTON.) (whatwg r7009) http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5599&r2=1.5600&f=h http://html5.org/tools/web-apps-tracker?from=7008&to=7009 =================================================================== RCS file: /sources/public/html5/spec/Overview.html,v retrieving revision 1.5599 retrieving revision 1.5600 diff -u -d -r1.5599 -r1.5600 --- Overview.html 22 Feb 2012 20:11:50 -0000 1.5599 +++ Overview.html 29 Feb 2012 21:24:49 -0000 1.5600 @@ -320,7 +320,7 @@ <h1>HTML5</h1> <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2> - <h2 class="no-num no-toc" id="editor-s-draft-22-february-2012">Editor's Draft 22 February 2012</h2> + <h2 class="no-num no-toc" id="editor-s-draft-29-february-2012">Editor's Draft 29 February 2012</h2> <dl><dt>Latest Published Version:</dt> <dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd> <dt>Latest Editor's Draft:</dt> @@ -467,7 +467,7 @@ Group</a> is the W3C working group responsible for this specification's progress along the W3C Recommendation track. - This specification is the 22 February 2012 Editor's Draft. + This specification is the 29 February 2012 Editor's Draft. </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 @@ -3205,11 +3205,15 @@ <li>The distinction between <dfn id="xml-documents">XML documents</dfn> and <dfn id="html-documents">HTML documents</dfn></li> <li>The terms <dfn id="quirks-mode">quirks mode</dfn>, <dfn id="limited-quirks-mode">limited-quirks mode</dfn>, and <dfn id="no-quirks-mode">no-quirks mode</dfn></li> <li>The algorithm to <dfn id="concept-node-clone" title="concept-node-clone">clone</dfn> a <code><a href="#node">Node</a></code>, and the concept of <dfn id="concept-node-clone-ext" title="concept-node-clone-ext">cloning steps</dfn> used by that algorithm</li> - <li>The concept of <dfn id="base-url-change-steps">base URL change steps</dfn> and the definition of what happens when an element is <dfn id="affected-by-a-base-url-change">affected by a base URL change</dfn>.</li> - <li>The concept of an element's <dfn id="concept-id" title="concept-id">unique identifier (ID)</dfn>.</li> + <li>The concept of <dfn id="base-url-change-steps">base URL change steps</dfn> and the definition of what happens when an element is <dfn id="affected-by-a-base-url-change">affected by a base URL change</dfn></li> + <li>The concept of an element's <dfn id="concept-id" title="concept-id">unique identifier (ID)</dfn></li> <li>The concept of a DOM <dfn id="concept-range" title="concept-range">range</dfn>.</li> + <li><dfn id="mutationobserver"><code>MutationObserver</code></dfn> interface</li> + <li>The <dfn id="mutationobserver-scripting-environment"><code>MutationObserver</code> <var title="">scripting environment</var></dfn> concept</li> + <li>The <dfn id="concept-mo-invoke" title="concept-mo-invoke">invoke <code>MutationObserver</code> objects</dfn> algorith,</li> + </ul><p>The term <dfn id="throw">throw</dfn> in this specification is used as defined in the DOM Core specification. The following <code><a href="#domexception">DOMException</a></code> types are defined in the DOM Core @@ -45961,8 +45965,20 @@ is no <a href="#entry-script">entry script</a>. It is changed by the <a href="#jump-to-a-code-entry-point">jump to a code entry-point</a> algorithm.</p> - <p class="note">There is at most one <a href="#event-loop">event loop</a> per - <a href="#unit-of-related-similar-origin-browsing-contexts">unit of related similar-origin browsing contexts</a>.</p> + <p>Each <a href="#unit-of-related-similar-origin-browsing-contexts">unit of related similar-origin browsing + contexts</a> also has a <dfn id="running-mutation-observers">running mutation observers</dfn> + flag, which must initially be false. It is used to prevent reentrant + invocation of the algorithm to <a href="#concept-mo-invoke" title="concept-mo-invoke">invoke <code>MutationObserver</code> + objects</a>. For the purposes of <code><a href="#mutationobserver">MutationObserver</a></code> + objects, each <a href="#unit-of-related-similar-origin-browsing-contexts">unit of related similar-origin browsing + contexts</a> is a distinct <var title="MutationObserver scripting + environment"><a href="#mutationobserver-scripting-environment">scripting environment</a></var>.</p> + + <p class="note">There is also at most one <a href="#event-loop">event loop</a> + per <a href="#unit-of-related-similar-origin-browsing-contexts">unit of related similar-origin browsing contexts</a> + (though several <a href="#unit-of-related-similar-origin-browsing-contexts" title="unit of related similar-origin browsing + contexts">units of related similar-origin browsing contexts</a> + can have a shared <a href="#event-loop">event loop</a>).</p> </div><h4 id="browsing-context-names"><span class="secno">5.1.6 </span>Browsing context names</h4><p>Browsing contexts can have a <dfn id="browsing-context-name">browsing context name</dfn>. By default, a browsing context has no name (its name is not set).<p>A <dfn id="valid-browsing-context-name">valid browsing context name</dfn> is any string with at @@ -51847,6 +51863,8 @@ <li><p>Set the <a href="#entry-script">entry script</a> back to whatever it was when this algorithm started.</li> + <li><p><a href="#perform-a-microtask-checkpoint">Perform a microtask checkpoint</a>.</li> + </ol><p>This algorithm is not invoked by one script calling another.</p> </div><div class="impl"> @@ -52197,6 +52215,8 @@ <li><p>Remove that task from its <a href="#task-queue">task queue</a>.</li> + <li><p><a href="#perform-a-microtask-checkpoint">Perform a microtask checkpoint</a>.</li> + <li><p><a href="#provide-a-stable-state">Provide a stable state</a>.</li> <li><p>If necessary, update the rendering or user interface of any @@ -52206,6 +52226,32 @@ <li><p>Return to the first step of the <a href="#event-loop">event loop</a>.</li> + </ol><hr><p>When a user agent is to <dfn id="perform-a-microtask-checkpoint">perform a microtask + checkpoint</dfn>, if the <var title="">running mutation + observers</var> flag is false, then the user agent must run the + following steps:</p> + + <ol><li><p>Let <var title="">running mutation observers</var> be + true.</li> + + <li> + + <p><a href="#concept-mo-invoke" title="concept-mo-invoke">Invoke + <code>MutationObserver</code> objects</a> for the <a href="#unit-of-related-similar-origin-browsing-contexts">unit + of related similar-origin browsing contexts</a> to which the + <a href="#script-s-browsing-context">script's browsing context</a> belongs.</p> + + <p class="note">This will typically fire scripted callbacks, which + calls the <a href="#jump-to-a-code-entry-point">jump to a code entry-point</a> algorithm, which + calls this <a href="#perform-a-microtask-checkpoint">perform a microtask checkpoint</a> algorithm + again, which is why we use the <var><a href="#running-mutation-observers">running mutation + observers</a></var> flag to avoid reentrancy.</p> + + </li> + + <li><p>Let <var title="">running mutation observers</var> be + false.</li> + </ol><hr><p>When the user agent is to <dfn id="provide-a-stable-state">provide a stable state</dfn>, if any asynchronously-running algorithms are <dfn id="await-a-stable-state" title="await a stable state">awaiting a stable state</dfn>, then the user agent must run @@ -67177,7 +67223,6 @@ :root:lang(ebu), :not(:lang(ebu)) > :lang(ebu) { quotes: '\201c' '\201d' '\2018' '\2019' } /* “ ” ‘ ’ */ :root:lang(ee), :not(:lang(ee)) > :lang(ee) { quotes: '\201c' '\201d' '\2018' '\2019' } /* “ ” ‘ ’ */ :root:lang(el), :not(:lang(el)) > :lang(el) { quotes: '\00ab' '\00bb' '\201c' '\201d' } /* « » “ ” */ -:root:lang(el-POLYTON), :not(:lang(el-POLYTON)) > :lang(el-POLYTON) { quotes: '\00ab' '\00bb' '\201b' '\201d' } /* « » ‛ ” */ :root:lang(en), :not(:lang(en)) > :lang(en) { quotes: '\201c' '\201d' '\2018' '\2019' } /* “ ” ‘ ’ */ :root:lang(en-GB), :not(:lang(en-GB)) > :lang(en-GB) { quotes: '\2018' '\2019' '\201c' '\201d' } /* ‘ ’ “ ” */ :root:lang(es), :not(:lang(es)) > :lang(es) { quotes: '\201c' '\201d' '\00ab' '\00bb' } /* “ ” « » */
Received on Wednesday, 29 February 2012 21:25:16 UTC