W3C home > Mailing lists > Public > public-html@w3.org > November 2011

CP remove hgroup add an outlineMask attribute.

From: Steve Faulkner <faulkner.steve@gmail.com>
Date: Mon, 7 Nov 2011 13:28:20 +0000
Message-ID: <CA+ri+VmXiiEKgj=_pt7BWxYsJQ9MvKv7aUhgRp+AG+JuU5_gkQ@mail.gmail.com>
To: HTMLWG WG <public-html@w3.org>, Paul Cotton <Paul.Cotton@microsoft.com>, Maciej Stachowiak <mjs@apple.com>, Sam Ruby <rubys@intertwingly.net>
Hi all,

CP remove hgroup add an outlineMask attribute.

Change Proposal

Replace <hgroup> with an attribute outlineMask that simply flags that a
heading should not be included in the document outline when producing an
outline using the outline algorithm.


The <hgroup> element has no uniquely useful function other than to remove a
heading from the outline generated using the outline algorithm.
It does not codify an existing usage pattern on the web. The creator of
<hgroup> describes it

"<hgroup> is in fact the result of awaiting patterns. The pattern is that
use <h1> and <h2> as heading and subheading respectively (without meaning
heading and subsection). All <hgroup> does is wrap them up so they don't
impact the outline algorithm."

Problem being with the statement "The pattern is that people use <h1> and
<h2 as heading and subheading respectively (without meaning heading and
subsection)" is that it is not a pattern that prevails over the other patterns
that people <http://wiki.whatwg.org/wiki/Hgroup_element> use to mark up
headings and subtitles. No cow paths are being paved with the addition of
the <hgroup>, in fact it is the opposite, it is an attempt to force a
pattern upon the markup where none previously existed, simply to support
the newly created outline algorithm.

The outlineMask attribute does not suffer from the issues ineherent with
the introduction of the <hgroup> as it simply does the same thing as the only
for the inclusion of <hgroup> in HTML5:

"The point of <hgroup> is to hide the subtitle from the outlining


Remove <hgroup> element.

Add outlineMask attribute, which is a boolean attribute. It can be set on
<h1> to <h6> elements. When present it indicates that the heading should
not be included in the document outline.

Author conformance advice should be provided to indicate when it should be
used. i.e. only on headings that the author considers are acting as
subtitles or subheadings.

The ARIA role mapping for a <h1> to <h6> that has an outlineMask attribute
is the same as a <h1> to <h6> without an outlineMask attribute set. User
agents MAY provide an indication that a heading is a subheading when the
attribute is set.


<h2 outlinemask>Subtitle</h2>

<h1>Second Title</h1>
   <h2 outlinemask>Second Subtitle 1</h2>
   <h2 outlinemask>Second Subtitle 2</h2>

   <h2 outlinemask>The Magical</h2>
   <h2 outlinemask>That Has</h2>
  <h2 outlinemask>Multiple Subtitles</h2>

 <hsub>Preceeding subtitle</hsub>


Removal of the <hgroup> element.

Legacy UAs will ignore the outlineMask attribute. This is not a big
problem, as legacy no user agents support the semantic processing of

authors may misuse the outlineMask attribute

with regards

Steve Faulkner
Technical Director - TPG

www.paciellogroup.com | www.HTML5accessibility.com |
HTML5: Techniques for providing useful text alternatives -
Web Accessibility Toolbar -
Received on Monday, 7 November 2011 13:29:36 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 9 May 2012 00:17:41 GMT