<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>20118</bug_id>
          
          <creation_ts>2012-11-28 11:37:10 +0000</creation_ts>
          <short_desc>Several clarifications / suggestions for improvement</short_desc>
          <delta_ts>2014-05-12 09:18:06 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>HTML WG</product>
          <component>maincontent element</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>WORKSFORME</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords>a11y</keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Silvia Pfeiffer">silviapfeiffer1</reporter>
          <assigned_to name="steve faulkner">faulkner.steve</assigned_to>
          <cc>hans.hillen</cc>
    
    <cc>public-html-admin</cc>
          
          <qa_contact name="HTML WG Bugzilla archive list">public-html-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>78986</commentid>
    <comment_count>0</comment_count>
    <who name="Silvia Pfeiffer">silviapfeiffer1</who>
    <bug_when>2012-11-28 11:37:10 +0000</bug_when>
    <thetext>Here are a few suggestions for how to clarify the specification of &lt;main&gt;:

* Introduce a &quot;Note&quot; that essentially says: The &lt;main&gt; element can be thought of as the element that encapsulates the area on the page that you would point out to a blind user as containing the core information of the page.

* Explain the second note better: &quot;Authors are advised to use ARIA role=main attribute on the main element until user agents implement the required role mapping.&quot; Add something like: &quot;The &lt;main&gt; element provides a landmark for accessibility technology [link to ARIA landmarks], which eg. allows a blind user to gain directly access to this part of the Web page.

* The examples could be much clearer if they didn&apos;t (just) include &lt;header&gt;, &lt;nav&gt; and &lt;footer&gt; elements, but others, in particular after &lt;header&gt; and before &lt;main&gt;. For example an iframe with an ad.

* I think that the &lt;nav&gt; in the example should not be part of the &lt;main&gt; section, because it&apos;s a landmark that can already be directly accessed. However, I think it might make sense to include two examples that differ on this point to explain that both are valid and both are useful for a11y users because in both cases they get the a11y user closer to &quot;where the action is&quot;.

* I think the &quot;Guidance for User Agents and HTML specification editors&quot; section needs to include something about which element should be chosen as the &quot;main&quot; landmark if there are both a &lt;main&gt; element and a role=main and they are different.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83278</commentid>
    <comment_count>1</comment_count>
    <who name="steve faulkner">faulkner.steve</who>
    <bug_when>2013-02-18 16:35:29 +0000</bug_when>
    <thetext>(In reply to comment #0)
&gt; Here are a few suggestions for how to clarify the specification of &lt;main&gt;:
&gt; 
&gt; * Introduce a &quot;Note&quot; that essentially says: The &lt;main&gt; element can be
&gt; thought of as the element that encapsulates the area on the page that you
&gt; would point out to a blind user as containing the core information of the
&gt; page.
&gt; 
&gt; * Explain the second note better: &quot;Authors are advised to use ARIA role=main
&gt; attribute on the main element until user agents implement the required role
&gt; mapping.&quot; Add something like: &quot;The &lt;main&gt; element provides a landmark for
&gt; accessibility technology [link to ARIA landmarks], which eg. allows a blind
&gt; user to gain directly access to this part of the Web page.
&gt; 
&gt; * The examples could be much clearer if they didn&apos;t (just) include &lt;header&gt;,
&gt; &lt;nav&gt; and &lt;footer&gt; elements, but others, in particular after &lt;header&gt; and
&gt; before &lt;main&gt;. For example an iframe with an ad.
&gt; 
&gt; * I think that the &lt;nav&gt; in the example should not be part of the &lt;main&gt;
&gt; section, because it&apos;s a landmark that can already be directly accessed.
&gt; However, I think it might make sense to include two examples that differ on
&gt; this point to explain that both are valid and both are useful for a11y users
&gt; because in both cases they get the a11y user closer to &quot;where the action is&quot;.
&gt; 
&gt; * I think the &quot;Guidance for User Agents and HTML specification editors&quot;
&gt; section needs to include something about which element should be chosen as
&gt; the &quot;main&quot; landmark if there are both a &lt;main&gt; element and a role=main and
&gt; they are different.

Hi Silvia, could you take a look at the current version in the spec and update any comments - thanks!</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>105690</commentid>
    <comment_count>2</comment_count>
    <who name="Silvia Pfeiffer">silviapfeiffer1</who>
    <bug_when>2014-05-12 08:38:28 +0000</bug_when>
    <thetext>(In reply to steve faulkner from comment #1)
&gt;
&gt; &gt; * I think the &quot;Guidance for User Agents and HTML specification editors&quot;
&gt; &gt; section needs to include something about which element should be chosen as
&gt; &gt; the &quot;main&quot; landmark if there are both a &lt;main&gt; element and a role=main and
&gt; &gt; they are different.

I don&apos;t know where this part of the extension spec ended up.

&gt; Hi Silvia, could you take a look at the current version in the spec and
&gt; update any comments - thanks!

I guess you ignored most of my suggestions because they were too accessibility specific for the HTML spec. That&apos;s fair enough. I&apos;m ok with how it looks now.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>105691</commentid>
    <comment_count>3</comment_count>
    <who name="steve faulkner">faulkner.steve</who>
    <bug_when>2014-05-12 08:44:00 +0000</bug_when>
    <thetext>(In reply to Silvia Pfeiffer from comment #2)
&gt; (In reply to steve faulkner from comment #1)
&gt; &gt;
&gt; &gt; &gt; * I think the &quot;Guidance for User Agents and HTML specification editors&quot;
&gt; &gt; &gt; section needs to include something about which element should be chosen as
&gt; &gt; &gt; the &quot;main&quot; landmark if there are both a &lt;main&gt; element and a role=main and
&gt; &gt; &gt; they are different.
&gt; 
&gt; I don&apos;t know where this part of the extension spec ended up.
&gt; 
&gt; &gt; Hi Silvia, could you take a look at the current version in the spec and
&gt; &gt; update any comments - thanks!
&gt; 
&gt; I guess you ignored most of my suggestions because they were too
&gt; accessibility specific for the HTML spec. That&apos;s fair enough. I&apos;m ok with
&gt; how it looks now.

thanks.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>105692</commentid>
    <comment_count>4</comment_count>
    <who name="Silvia Pfeiffer">silviapfeiffer1</who>
    <bug_when>2014-05-12 08:49:47 +0000</bug_when>
    <thetext>(In reply to steve faulkner from comment #3)
&gt; (In reply to Silvia Pfeiffer from comment #2)
&gt; &gt; (In reply to steve faulkner from comment #1)
&gt; &gt; &gt;
&gt; &gt; &gt; &gt; * I think the &quot;Guidance for User Agents and HTML specification editors&quot;
&gt; &gt; &gt; &gt; section needs to include something about which element should be chosen as
&gt; &gt; &gt; &gt; the &quot;main&quot; landmark if there are both a &lt;main&gt; element and a role=main and
&gt; &gt; &gt; &gt; they are different.
&gt; &gt; 
&gt; &gt; I don&apos;t know where this part of the extension spec ended up.

I&apos;d still like an answer to this, if you don&apos;t mind. :-)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>105697</commentid>
    <comment_count>5</comment_count>
    <who name="steve faulkner">faulkner.steve</who>
    <bug_when>2014-05-12 09:18:06 +0000</bug_when>
    <thetext>(In reply to Silvia Pfeiffer from comment #4)
&gt; (In reply to steve faulkner from comment #3)
&gt; &gt; (In reply to Silvia Pfeiffer from comment #2)
&gt; &gt; &gt; (In reply to steve faulkner from comment #1)
&gt; &gt; &gt; &gt;
&gt; &gt; &gt; &gt; &gt; * I think the &quot;Guidance for User Agents and HTML specification editors&quot;
&gt; &gt; &gt; &gt; &gt; section needs to include something about which element should be chosen as
&gt; &gt; &gt; &gt; &gt; the &quot;main&quot; landmark if there are both a &lt;main&gt; element and a role=main and
&gt; &gt; &gt; &gt; &gt; they are different.
&gt; &gt; &gt; 
&gt; &gt; &gt; I don&apos;t know where this part of the extension spec ended up.
&gt; 
&gt; I&apos;d still like an answer to this, if you don&apos;t mind. :-)

sure, sorry.
I didn&apos;t add any guidance yet for a few reasons:
1. there is no reliable way across platforms acc APIs to  differentiate between &lt;main role=main&gt; and &lt;div role=main&gt;
both are presented in the acc tree as role=main, depending on the acc API the tagname is available as an object attribute, but its exposure is API dependent.
2. I have been keeping an eye out for use of role=main/&lt;main&gt; in the wild, grepping data as it becomes available. Happily I have found no use of multiple &lt;main&gt; or role=main so far , but the number of instances of use is low, so that may change. I will continue to review data and see what patterns emerge and base any advice added to the spec on that. 

It may be we end up adding mapping requirements for main like we did for header/footer, which makes the mapping of banner/contentinfo dependent on ancestor elements.

&quot;footer element that is not a descendant of an article or section element. - contentinfo role&quot; 
http://www.w3.org/html/wg/drafts/html/master/dom.html#sec-strong-native-semantics</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>