[html5] r7234 - [t] (0) Let tools decide how to render <hgroup>s in ToCs and so on. Fixing https [...]

whatwg at whatwg.org whatwg at whatwg.org
Thu Aug 9 11:01:00 PDT 2012


Author: ianh
Date: 2012-08-09 11:00:58 -0700 (Thu, 09 Aug 2012)
New Revision: 7234

Modified:
   complete.html
   index
   source
Log:
[t] (0) Let tools decide how to render <hgroup>s in ToCs and so on.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=14707
Affected topics: HTML

Modified: complete.html
===================================================================
--- complete.html	2012-08-09 17:42:52 UTC (rev 7233)
+++ complete.html	2012-08-09 18:00:58 UTC (rev 7234)
@@ -18460,15 +18460,6 @@
   multiple levels, such as subheadings, alternative titles, or
   taglines.</p>
 
-  <p>For the purposes of document summaries, outlines, and the like,
-  the text of <code><a href=#the-hgroup-element>hgroup</a></code> elements is defined to be the text
-  of the highest <a href=#rank title=rank>ranked</a>
-  <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code>–<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code> element descendant of the
-  <code><a href=#the-hgroup-element>hgroup</a></code> element, if there are any such elements, and the
-  first such element if there are multiple elements with that
-  <a href=#rank>rank</a>. If there are no such elements, then the text of
-  the <code><a href=#the-hgroup-element>hgroup</a></code> element is the empty string.</p>
-
   <p>Other elements of <a href=#heading-content>heading content</a> in the
   <code><a href=#the-hgroup-element>hgroup</a></code> element indicate subheadings or subtitles.</p>
 
@@ -18484,27 +18475,42 @@
 
   <div class=example>
 
-   <p>Here are some examples of valid headings. In each case, the
-   emphasized text represents the text that would be used as the
-   heading in an application extracting heading data and ignoring
-   subheadings.</p>
+   <p>Here are some examples of valid headings.</p>
 
-   <pre><hgroup>
- <h1><strong>The reality dysfunction</strong></h1>
+    <pre><hgroup>
+ <h1>The reality dysfunction</h1>
  <h2>Space is not the only void</h2>
 </hgroup></pre>
 
-   <pre><hgroup>
- <h1><strong>Dr. Strangelove</strong></h1>
+    <pre><hgroup>
+ <h1>Dr. Strangelove</h1>
  <h2>Or: How I Learned to Stop Worrying and Love the Bomb</h2>
 </hgroup></pre>
 
-  <p>The point of using <code><a href=#the-hgroup-element>hgroup</a></code> in these examples is to
-  mask the <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h2</a></code> element (which acts as a secondary title)
-  from the <a href=#outline>outline</a> algorithm.</p><!--
-  http://www.brucelawson.co.uk/2009/html-5-is-a-mess/#comment-618895
-  -->
+   <p>The point of using <code><a href=#the-hgroup-element>hgroup</a></code> in these examples is to
+   mask the <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h2</a></code> element (which acts as a secondary title)
+   from the <a href=#outline>outline</a> algorithm.</p><!--
+   http://www.brucelawson.co.uk/2009/html-5-is-a-mess/#comment-618895
+   -->
 
+   <p>How a user agent exposes such multi-level headings in user
+   interfaces (e.g. in tables of contents or search results) is left
+   open to implementors, as it is a user interface issue. The first
+   example above could be rendered as:</p>
+
+   <pre>The reality dysfunction: Space is not the only void</pre>
+
+   <p>Alternatively, it could look like this:
+
+   <pre>The reality dysfunction (Space is not the only void)</pre>
+
+   <p>In interfaces where a title can be rendered on multiple lines,
+   it could be rendered as follows, maybe with the first line in a
+   bigger font size:</p>
+
+   <pre>The reality dysfunction
+Space is not the only void</pre>
+
   </div>
 
 

Modified: index
===================================================================
--- index	2012-08-09 17:42:52 UTC (rev 7233)
+++ index	2012-08-09 18:00:58 UTC (rev 7234)
@@ -18460,15 +18460,6 @@
   multiple levels, such as subheadings, alternative titles, or
   taglines.</p>
 
-  <p>For the purposes of document summaries, outlines, and the like,
-  the text of <code><a href=#the-hgroup-element>hgroup</a></code> elements is defined to be the text
-  of the highest <a href=#rank title=rank>ranked</a>
-  <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code>–<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code> element descendant of the
-  <code><a href=#the-hgroup-element>hgroup</a></code> element, if there are any such elements, and the
-  first such element if there are multiple elements with that
-  <a href=#rank>rank</a>. If there are no such elements, then the text of
-  the <code><a href=#the-hgroup-element>hgroup</a></code> element is the empty string.</p>
-
   <p>Other elements of <a href=#heading-content>heading content</a> in the
   <code><a href=#the-hgroup-element>hgroup</a></code> element indicate subheadings or subtitles.</p>
 
@@ -18484,27 +18475,42 @@
 
   <div class=example>
 
-   <p>Here are some examples of valid headings. In each case, the
-   emphasized text represents the text that would be used as the
-   heading in an application extracting heading data and ignoring
-   subheadings.</p>
+   <p>Here are some examples of valid headings.</p>
 
-   <pre><hgroup>
- <h1><strong>The reality dysfunction</strong></h1>
+    <pre><hgroup>
+ <h1>The reality dysfunction</h1>
  <h2>Space is not the only void</h2>
 </hgroup></pre>
 
-   <pre><hgroup>
- <h1><strong>Dr. Strangelove</strong></h1>
+    <pre><hgroup>
+ <h1>Dr. Strangelove</h1>
  <h2>Or: How I Learned to Stop Worrying and Love the Bomb</h2>
 </hgroup></pre>
 
-  <p>The point of using <code><a href=#the-hgroup-element>hgroup</a></code> in these examples is to
-  mask the <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h2</a></code> element (which acts as a secondary title)
-  from the <a href=#outline>outline</a> algorithm.</p><!--
-  http://www.brucelawson.co.uk/2009/html-5-is-a-mess/#comment-618895
-  -->
+   <p>The point of using <code><a href=#the-hgroup-element>hgroup</a></code> in these examples is to
+   mask the <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h2</a></code> element (which acts as a secondary title)
+   from the <a href=#outline>outline</a> algorithm.</p><!--
+   http://www.brucelawson.co.uk/2009/html-5-is-a-mess/#comment-618895
+   -->
 
+   <p>How a user agent exposes such multi-level headings in user
+   interfaces (e.g. in tables of contents or search results) is left
+   open to implementors, as it is a user interface issue. The first
+   example above could be rendered as:</p>
+
+   <pre>The reality dysfunction: Space is not the only void</pre>
+
+   <p>Alternatively, it could look like this:
+
+   <pre>The reality dysfunction (Space is not the only void)</pre>
+
+   <p>In interfaces where a title can be rendered on multiple lines,
+   it could be rendered as follows, maybe with the first line in a
+   bigger font size:</p>
+
+   <pre>The reality dysfunction
+Space is not the only void</pre>
+
   </div>
 
 

Modified: source
===================================================================
--- source	2012-08-09 17:42:52 UTC (rev 7233)
+++ source	2012-08-09 18:00:58 UTC (rev 7234)
@@ -19785,15 +19785,6 @@
   multiple levels, such as subheadings, alternative titles, or
   taglines.</p>
 
-  <p>For the purposes of document summaries, outlines, and the like,
-  the text of <code>hgroup</code> elements is defined to be the text
-  of the highest <span title="rank">ranked</span>
-  <code>h1</code>–<code>h6</code> element descendant of the
-  <code>hgroup</code> element, if there are any such elements, and the
-  first such element if there are multiple elements with that
-  <span>rank</span>. If there are no such elements, then the text of
-  the <code>hgroup</code> element is the empty string.</p>
-
   <p>Other elements of <span>heading content</span> in the
   <code>hgroup</code> element indicate subheadings or subtitles.</p>
 
@@ -19809,27 +19800,42 @@
 
   <div class="example">
 
-   <p>Here are some examples of valid headings. In each case, the
-   emphasized text represents the text that would be used as the
-   heading in an application extracting heading data and ignoring
-   subheadings.</p>
+   <p>Here are some examples of valid headings.</p>
 
-   <pre><hgroup>
- <h1><strong>The reality dysfunction</strong></h1>
+    <pre><hgroup>
+ <h1>The reality dysfunction</h1>
  <h2>Space is not the only void</h2>
 </hgroup></pre>
 
-   <pre><hgroup>
- <h1><strong>Dr. Strangelove</strong></h1>
+    <pre><hgroup>
+ <h1>Dr. Strangelove</h1>
  <h2>Or: How I Learned to Stop Worrying and Love the Bomb</h2>
 </hgroup></pre>
 
-  <p>The point of using <code>hgroup</code> in these examples is to
-  mask the <code>h2</code> element (which acts as a secondary title)
-  from the <span>outline</span> algorithm.</p><!--
-  http://www.brucelawson.co.uk/2009/html-5-is-a-mess/#comment-618895
-  -->
+   <p>The point of using <code>hgroup</code> in these examples is to
+   mask the <code>h2</code> element (which acts as a secondary title)
+   from the <span>outline</span> algorithm.</p><!--
+   http://www.brucelawson.co.uk/2009/html-5-is-a-mess/#comment-618895
+   -->
 
+   <p>How a user agent exposes such multi-level headings in user
+   interfaces (e.g. in tables of contents or search results) is left
+   open to implementors, as it is a user interface issue. The first
+   example above could be rendered as:</p>
+
+   <pre>The reality dysfunction: Space is not the only void</pre>
+
+   <p>Alternatively, it could look like this:
+
+   <pre>The reality dysfunction (Space is not the only void)</pre>
+
+   <p>In interfaces where a title can be rendered on multiple lines,
+   it could be rendered as follows, maybe with the first line in a
+   bigger font size:</p>
+
+   <pre>The reality dysfunction
+Space is not the only void</pre>
+
   </div>
 
 




More information about the Commit-Watchers mailing list