W3C home > Mailing lists > Public > whatwg@whatwg.org > August 2009

[whatwg] Note on the DETAILS element

From: Jeremy Keith <jeremy@adactio.com>
Date: Wed, 26 Aug 2009 23:49:42 +0100
Message-ID: <CD0A8B00-0F65-4A1C-A0A3-718075AA4D4F@adactio.com>
The text for <details> begins with a definition:

"The hgroup element represents the heading of a section. The element  
is used to group a set of h1?h6 elements when the heading has multiple  
levels, such as subheadings, alternative titles, or taglines."

But then has this note immediately afterwards:

"The point of hgroup is to mask an h2 element (that acts as a  
secondary title) from the outline algorithm."

As far as I can tell, this is incorrect. The point of an hgroup is  
actually to mask *all but one* heading element from the outline  
algorithm.

The note *does* apply to the examples provided:

<hgroup>
<h1>Dr. Strangelove</h1>
<h2>Or: How I Learned to Stop Worrying and Love the Bomb</h2>
</hgroup>

...but wouldn't be true in this case:

<hgroup>
<h3>Dr. Strangelove</h3>
<h4>Or: How I Learned to Stop Worrying and Love the Bomb</h4>
</hgroup>

In this case, the hgroup element is masking an h4 element (that acts  
as a secondary title) from the outline algorithm.

Even in cases where the hgroup *is* masking an h2, the note would  
still be incorrect because more heading elements can be hidden from  
the outline algorithm. e.g.:

<hgroup>
<h1>Dr. Strangelove</h1>
<h2>Or: How I Learned to Stop Worrying and Love the Bomb</h2>
<h3>By Stanley Kubrick</h3>
</hgroup>

The note would make sense if it were moved down to the examples and  
prefaced with "In this case..."

-- 
Jeremy Keith

a d a c t i o

http://adactio.com/
Received on Wednesday, 26 August 2009 15:49:42 UTC

This archive was generated by hypermail 2.4.0 : Wednesday, 22 January 2020 16:59:16 UTC