W3C home > Mailing lists > Public > public-html-commits@w3.org > October 2009

html5/spec Overview.html,1.3279,1.3280

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 13 Oct 2009 09:33:11 +0000
To: public-html-commits@w3.org
Message-Id: <E1Mxdkl-0001aK-Se@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv6056

Modified Files:
	Overview.html 
Log Message:
Try to explain 'transparent' with an example. (whatwg r4125)

Index: Overview.html
===================================================================
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:42:57 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 13 October 2009 09:43:14 GMT