[html5] r4125 - [e] (0) Try to explain 'transparent' with an example.

[whatwg at whatwg.org]

Author: ianh
Date: 2009-10-13 02:44:17 -0700 (Tue, 13 Oct 2009)
New Revision: 4125

Modified:
   complete.html
   index
   source
Log:
[e] (0) Try to explain 'transparent' with an example.

Modified: complete.html
===================================================================
--- complete.html	2009-10-13 07:34:20 UTC (rev 4124)
+++ complete.html	2009-10-13 09:44:17 UTC (rev 4125)
@@ -8998,6 +8998,23 @@
   element, by the children in the "transparent" part of their content
   model, retaining order.</p>
 
+  <div class=example>
+
+   <p>Consider the following markup fragment:</p>
+
+   <pre><p>Hello <a href="world.html"><em>wonderful</em> world</a>!</p></pre>
+
+   <p>Its DOM looks like the following:</p>
+
+   <ul class=domTree><li class=t1><code><a href=#the-p-element>p</a></code><ul><li class=t3><code>#text</code>: <span title="">Hello </span><li class=t1><code><a href=#the-a-element>a</a></code> <span class=t2><code class="attribute name">href</code>="<code class="attribute value">world.html</code>"</span><ul><li class=t1><code><a href=#the-em-element>em</a></code><ul><li class=t3><code>#text</code>: <span title="">wonderful</span></ul><li class=t3><code>#text</code>: <span title=""> world</span></ul><li class=t3><code>#text</code>: <span title="">!</span></ul></ul><p>The content model of the <code><a href=#the-a-element>a</a></code> element is
+   <a href=#transparent>transparent</a>. To see if its contents are conforming,
+   therefore, the element is replaced by its contents:</p>
+
+   <ul class=domTree><li class=t1><code><a href=#the-p-element>p</a></code><ul><li class=t3><code>#text</code>: <span title="">Hello </span><li class=t1><code><a href=#the-em-element>em</a></code><ul><li class=t3><code>#text</code>: <span title="">wonderful</span><li class=t3><code>#text</code>: <span title=""> world</span></ul><li class=t3><code>#text</code>: <span title="">!</span></ul></ul><p>Since that is conforming, the contents of the <code><a href=#the-a-element>a</a></code> are
+   conforming in the original fragment.</p>
+
+  </div>
+
   <p>When a transparent element has no parent, then the part of its
   content model that is "transparent" must instead be treated as
   accepting any <a href=#flow-content>flow content</a>.</p>

Modified: index
===================================================================
--- index	2009-10-13 07:34:20 UTC (rev 4124)
+++ index	2009-10-13 09:44:17 UTC (rev 4125)
@@ -8828,6 +8828,23 @@
   element, by the children in the "transparent" part of their content
   model, retaining order.</p>
 
+  <div class=example>
+
+   <p>Consider the following markup fragment:</p>
+
+   <pre><p>Hello <a href="world.html"><em>wonderful</em> world</a>!</p></pre>
+
+   <p>Its DOM looks like the following:</p>
+
+   <ul class=domTree><li class=t1><code><a href=#the-p-element>p</a></code><ul><li class=t3><code>#text</code>: <span title="">Hello </span><li class=t1><code><a href=#the-a-element>a</a></code> <span class=t2><code class="attribute name">href</code>="<code class="attribute value">world.html</code>"</span><ul><li class=t1><code><a href=#the-em-element>em</a></code><ul><li class=t3><code>#text</code>: <span title="">wonderful</span></ul><li class=t3><code>#text</code>: <span title=""> world</span></ul><li class=t3><code>#text</code>: <span title="">!</span></ul></ul><p>The content model of the <code><a href=#the-a-element>a</a></code> element is
+   <a href=#transparent>transparent</a>. To see if its contents are conforming,
+   therefore, the element is replaced by its contents:</p>
+
+   <ul class=domTree><li class=t1><code><a href=#the-p-element>p</a></code><ul><li class=t3><code>#text</code>: <span title="">Hello </span><li class=t1><code><a href=#the-em-element>em</a></code><ul><li class=t3><code>#text</code>: <span title="">wonderful</span><li class=t3><code>#text</code>: <span title=""> world</span></ul><li class=t3><code>#text</code>: <span title="">!</span></ul></ul><p>Since that is conforming, the contents of the <code><a href=#the-a-element>a</a></code> are
+   conforming in the original fragment.</p>
+
+  </div>
+
   <p>When a transparent element has no parent, then the part of its
   content model that is "transparent" must instead be treated as
   accepting any <a href=#flow-content>flow content</a>.</p>

Modified: source
===================================================================
--- source	2009-10-13 07:34:20 UTC (rev 4124)
+++ source	2009-10-13 09:44:17 UTC (rev 4125)
@@ -9060,6 +9060,27 @@
   element, by the children in the "transparent" part of their content
   model, retaining order.</p>
 
+  <div class="example">
+
+   <p>Consider the following markup fragment:</p>
+
+   <pre><p>Hello <a href="world.html"><em>wonderful</em> world</a>!</p></pre>
+
+   <p>Its DOM looks like the following:</p>
+
+   <ul class="domTree"><li class="t1"><code>p</code><ul><li class="t3"><code>#text</code>: <span title="">Hello </span></li><li class="t1"><code>a</code> <span class="t2"><code class="attribute name">href</code>="<code class="attribute value">world.html</code>"</span><ul><li class="t1"><code>em</code><ul><li class="t3"><code>#text</code>: <span title="">wonderful</span></li></ul></li><li class="t3"><code>#text</code>: <span title=""> world</span></li></ul></li><li class="t3"><code>#text</code>: <span title="">!</span></li></ul></li></ul>
+
+   <p>The content model of the <code>a</code> element is
+   <span>transparent</span>. To see if its contents are conforming,
+   therefore, the element is replaced by its contents:</p>
+
+   <ul class="domTree"><li class="t1"><code>p</code><ul><li class="t3"><code>#text</code>: <span title="">Hello </span></li><li class="t1"><code>em</code><ul><li class="t3"><code>#text</code>: <span title="">wonderful</span></li><li class="t3"><code>#text</code>: <span title=""> world</span></li></ul></li><li class="t3"><code>#text</code>: <span title="">!</span></li></ul></li></ul>
+
+   <p>Since that is conforming, the contents of the <code>a</code> are
+   conforming in the original fragment.</p>
+
+  </div>
+
   <p>When a transparent element has no parent, then the part of its
   content model that is "transparent" must instead be treated as
   accepting any <span>flow content</span>.</p>