hixie: Try to explain 'transparent' with an example. (whatwg r4125)

hixie: Try to explain 'transparent' with an example. (whatwg r4125)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.3279&r2=1.3280&f=h
http://html5.org/tools/web-apps-tracker?from=4124&to=4125

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3279
retrieving revision 1.3280
diff -u -d -r1.3279 -r1.3280
--- Overview.html 13 Oct 2009 07:23:11 -0000 1.3279
+++ Overview.html 13 Oct 2009 09:33:08 -0000 1.3280
@@ -7842,7 +7842,22 @@
   parts must not contain content that would not be conformant if all
   transparent elements in the tree were replaced, in their parent
   element, by the children in the "transparent" part of their content
-  model, retaining order.<p>When a transparent element has no parent, then the part of its
+  model, retaining order.<div class="example">
+
+   <p>Consider the following markup fragment:</p>
+
+   <pre>&lt;p&gt;Hello &lt;a href="world.html"&gt;&lt;em&gt;wonderful&lt;/em&gt; world&lt;/a&gt;!&lt;/p&gt;</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>.<h5 id="paragraphs"><span class="secno">3.2.5.3 </span>Paragraphs</h5><p class="note">The term <a href="#paragraph">paragraph</a> as defined in this
   section is distinct from (though related to) the <code><a href="#the-p-element">p</a></code>

Received on Tuesday, 13 October 2009 09:43:50 UTC