Skip to content

Commit

Permalink
Define host concept for <template> and Shadow DOM so it's clear what …
Browse files Browse the repository at this point in the history
  • Loading branch information
Anne van Kesteren committed Feb 6, 2013
1 parent 8469709 commit bc62c36
Show file tree
Hide file tree
Showing 3 changed files with 58 additions and 10 deletions.
Binary file added .DS_Store
Binary file not shown.
32 changes: 28 additions & 4 deletions Overview.src.html
Expand Up @@ -1444,9 +1444,15 @@ <h4>Mutation algorithms</h4>
<span title=concept-throw>throw</span> a
"<code>HierarchyRequestError</code>" and terminate these steps.

<li><p>If <var title>node</var> is an
<li><p>If <var title>node</var> is either an
<span title=concept-tree-inclusive-ancestor>inclusive ancestor</span> of
<var title>parent</var>, <span title=concept-throw>throw</span> a
<var title>parent</var>, or <var title>node</var>'s
<span title=concept-tree-root>root</span> is a <code>DocumentFragment</code>
<span title=concept-node>node</span> with an associated
<span title=concept-DocumentFragment-host>host</span> and <var title>node</var> is an
<span title=concept-tree-inclusive-ancestor>inclusive ancestor</span> of that
<span title=concept-DocumentFragment-host>host</span>,
<span title=concept-throw>throw</span> a
"<code>HierarchyRequestError</code>" and terminate these steps.

<li><p>If <var title>child</var> is not null and its
Expand Down Expand Up @@ -1634,9 +1640,15 @@ <h4>Mutation algorithms</h4>
<span title=concept-throw>throw</span> a
"<code>HierarchyRequestError</code>" and terminate these steps.

<li><p>If <var title>node</var> is an
<li><p>If <var title>node</var> is either an
<span title=concept-tree-inclusive-ancestor>inclusive ancestor</span> of
<var title>parent</var>, <span title=concept-throw>throw</span> a
<var title>parent</var>, or <var title>node</var>'s
<span title=concept-tree-root>root</span> is a <code>DocumentFragment</code>
<span title=concept-node>node</span> with an associated
<span title=concept-DocumentFragment-host>host</span> and <var title>node</var> is an
<span title=concept-tree-inclusive-ancestor>inclusive ancestor</span> of that
<span title=concept-DocumentFragment-host>host</span>,
<span title=concept-throw>throw</span> a
"<code>HierarchyRequestError</code>" and terminate these steps.

<li><p>If <var title>child</var>'s
Expand Down Expand Up @@ -4748,6 +4760,18 @@ <h3>Interface <code>DocumentFragment</code></h3>
<pre class=idl>interface <dfn>DocumentFragment</dfn> : <span>Node</span> {
};</pre>

<p>A <code>DocumentFragment</code> <span title=concept-node>node</span> can have an
associated <span title=concept-element>element</span> named
<dfn title=concept-DocumentFragment-host>host</dfn>.

<p class=note>The <code>DocumentFragment</code> <span title=concept-node>node</span>'s
<span title=concept-DocumentFragment-host>host</span> concept is useful for HTML's
<code>template</code> element and the <code>ShadowRoot</code> object and impacts the
<span title=concept-node-pre-insert>pre-insert</span> and
<span title=concept-node-replace>replace</span> algorithms.

<!-- XXX xref
XXX ShadowRoot is a Node technically -->


<h3>Interface <code>DocumentType</code></h3>
Expand Down
36 changes: 30 additions & 6 deletions dom-core.html
Expand Up @@ -10,7 +10,7 @@

<p><a class="logo" href="//www.whatwg.org/"><img alt="WHATWG" height="100" src="//resources.whatwg.org/logo-dom.svg" width="100"></a></p>
<h1>DOM</h1>
<h2 class="no-num no-toc" id="living-standard-—-last-updated-25-january-2013">Living Standard — Last Updated 25 January 2013</h2>
<h2 class="no-num no-toc" id="living-standard-—-last-updated-6-february-2013">Living Standard — Last Updated 6 February 2013</h2>

<dl>
<dt>This Version:
Expand Down Expand Up @@ -42,7 +42,7 @@ <h2 class="no-num no-toc" id="living-standard-—-last-updated-25-january-2013">
<p class="copyright"><a href="http://creativecommons.org/publicdomain/zero/1.0/" rel="license"><img alt="CC0" src="http://i.creativecommons.org/p/zero/1.0/80x15.png"></a>
To the extent possible under law, the editors have waived all copyright and
related or neighboring rights to this work. In addition, as of
25 January 2013, the editors have made this specification available
6 February 2013, the editors have made this specification available
under the
<a href="http://www.openwebfoundation.org/legal/the-owf-1-0-agreements/owfa-1-0" rel="license">Open Web Foundation Agreement Version 1.0</a>,
which is available at
Expand Down Expand Up @@ -1517,9 +1517,15 @@ <h4 id="mutation-algorithms"><span class="secno">5.2.1 </span>Mutation algorithm
<a href="#concept-throw" title="concept-throw">throw</a> a
"<code><a href="#hierarchyrequesterror">HierarchyRequestError</a></code>" and terminate these steps.

<li><p>If <var title="">node</var> is an
<li><p>If <var title="">node</var> is either an
<a href="#concept-tree-inclusive-ancestor" title="concept-tree-inclusive-ancestor">inclusive ancestor</a> of
<var title="">parent</var>, <a href="#concept-throw" title="concept-throw">throw</a> a
<var title="">parent</var>, or <var title="">node</var>'s
<a href="#concept-tree-root" title="concept-tree-root">root</a> is a <code><a href="#documentfragment">DocumentFragment</a></code>
<a href="#concept-node" title="concept-node">node</a> with an associated
<a href="#concept-documentfragment-host" title="concept-DocumentFragment-host">host</a> and <var title="">node</var> is an
<a href="#concept-tree-inclusive-ancestor" title="concept-tree-inclusive-ancestor">inclusive ancestor</a> of that
<a href="#concept-documentfragment-host" title="concept-DocumentFragment-host">host</a>,
<a href="#concept-throw" title="concept-throw">throw</a> a
"<code><a href="#hierarchyrequesterror">HierarchyRequestError</a></code>" and terminate these steps.

<li><p>If <var title="">child</var> is not null and its
Expand Down Expand Up @@ -1707,9 +1713,15 @@ <h4 id="mutation-algorithms"><span class="secno">5.2.1 </span>Mutation algorithm
<a href="#concept-throw" title="concept-throw">throw</a> a
"<code><a href="#hierarchyrequesterror">HierarchyRequestError</a></code>" and terminate these steps.

<li><p>If <var title="">node</var> is an
<li><p>If <var title="">node</var> is either an
<a href="#concept-tree-inclusive-ancestor" title="concept-tree-inclusive-ancestor">inclusive ancestor</a> of
<var title="">parent</var>, <a href="#concept-throw" title="concept-throw">throw</a> a
<var title="">parent</var>, or <var title="">node</var>'s
<a href="#concept-tree-root" title="concept-tree-root">root</a> is a <code><a href="#documentfragment">DocumentFragment</a></code>
<a href="#concept-node" title="concept-node">node</a> with an associated
<a href="#concept-documentfragment-host" title="concept-DocumentFragment-host">host</a> and <var title="">node</var> is an
<a href="#concept-tree-inclusive-ancestor" title="concept-tree-inclusive-ancestor">inclusive ancestor</a> of that
<a href="#concept-documentfragment-host" title="concept-DocumentFragment-host">host</a>,
<a href="#concept-throw" title="concept-throw">throw</a> a
"<code><a href="#hierarchyrequesterror">HierarchyRequestError</a></code>" and terminate these steps.

<li><p>If <var title="">child</var>'s
Expand Down Expand Up @@ -4808,6 +4820,18 @@ <h3 id="interface-documentfragment"><span class="secno">5.6 </span>Interface <co
<pre class="idl">interface <dfn id="documentfragment">DocumentFragment</dfn> : <a href="#node">Node</a> {
};</pre>

<p>A <code><a href="#documentfragment">DocumentFragment</a></code> <a href="#concept-node" title="concept-node">node</a> can have an
associated <a href="#concept-element" title="concept-element">element</a> named
<dfn id="concept-documentfragment-host" title="concept-DocumentFragment-host">host</dfn>.

<p class="note">The <code><a href="#documentfragment">DocumentFragment</a></code> <a href="#concept-node" title="concept-node">node</a>'s
<a href="#concept-documentfragment-host" title="concept-DocumentFragment-host">host</a> concept is useful for HTML's
<code>template</code> element and the <code>ShadowRoot</code> object and impacts the
<a href="#concept-node-pre-insert" title="concept-node-pre-insert">pre-insert</a> and
<a href="#concept-node-replace" title="concept-node-replace">replace</a> algorithms.

<!-- XXX xref
XXX ShadowRoot is a Node technically -->


<h3 id="interface-documenttype"><span class="secno">5.7 </span>Interface <code><a href="#documenttype">DocumentType</a></code></h3>
Expand Down

0 comments on commit bc62c36

Please sign in to comment.