<?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>18438</bug_id>
          
          <creation_ts>2012-07-30 17:02:45 +0000</creation_ts>
          <short_desc>The Table summary attribute</short_desc>
          <delta_ts>2013-03-30 18:22:45 +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>HTML5 spec</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>other</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords>a11y, a11y_table_summary</keywords>
          <priority>P2</priority>
          <bug_severity>trivial</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Devarshi Pant">devarshipant</reporter>
          <assigned_to name="steve faulkner">faulkner.steve</assigned_to>
          <cc>faulkner.steve</cc>
    
    <cc>john</cc>
    
    <cc>joshue.oconnor</cc>
    
    <cc>mike</cc>
    
    <cc>plh</cc>
    
    <cc>public-html-a11y</cc>
    
    <cc>public-html-admin</cc>
    
    <cc>public-html-wg-issue-tracking</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>71665</commentid>
    <comment_count>0</comment_count>
    <who name="Devarshi Pant">devarshipant</who>
    <bug_when>2012-07-30 17:02:45 +0000</bug_when>
    <thetext>I am not sure regarding the fate of the summary attribute. Nevertheless, came across a scenario (apologies if it is a duplicate):

***A screen reader like JAWS will concatenate column headers and linearize the data cells. JAWS then presents this information in the table utility list***

When a summary attribute is applied, the problem seems to disappear.

-Devarshi</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73404</commentid>
    <comment_count>1</comment_count>
    <who name="Joshue O Connor">joshue.oconnor</who>
    <bug_when>2012-09-07 08:41:02 +0000</bug_when>
    <thetext>Devarshi, the @summary is has been obsoleted in HTML5, have you tried using a method like aria-describedby or similar to see if this is a suitable alternative?

(In reply to comment #0)
&gt; I am not sure regarding the fate of the summary attribute. Nevertheless, came
&gt; across a scenario (apologies if it is a duplicate):
&gt; 
&gt; ***A screen reader like JAWS will concatenate column headers and linearize the
&gt; data cells. JAWS then presents this information in the table utility list***
&gt; 
&gt; When a summary attribute is applied, the problem seems to disappear.
&gt; 
&gt; -Devarshi</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73428</commentid>
    <comment_count>2</comment_count>
    <who name="Devarshi Pant">devarshipant</who>
    <bug_when>2012-09-07 15:11:12 +0000</bug_when>
    <thetext>Josh,

I am not sure but applications developed with html5 do expose the summary attribute info to JAWS. Why does this happen? 

aria-describedby or similar alternatives, in my view, may not be as robust as the table summary.

Thanks,
-Devarshi

(In reply to comment #1)
&gt; Devarshi, the @summary is has been obsoleted in HTML5, have you tried using a
&gt; method like aria-describedby or similar to see if this is a suitable
&gt; alternative?
&gt; (In reply to comment #0)
&gt; &gt; I am not sure regarding the fate of the summary attribute. Nevertheless, came
&gt; &gt; across a scenario (apologies if it is a duplicate):
&gt; &gt; 
&gt; &gt; ***A screen reader like JAWS will concatenate column headers and linearize the
&gt; &gt; data cells. JAWS then presents this information in the table utility list***
&gt; &gt; 
&gt; &gt; When a summary attribute is applied, the problem seems to disappear.
&gt; &gt; 
&gt; &gt; -Devarshi</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73436</commentid>
    <comment_count>3</comment_count>
    <who name="Joshue O Connor">joshue.oconnor</who>
    <bug_when>2012-09-07 18:13:39 +0000</bug_when>
    <thetext>@Devarshi

The user agent (the screen reader) still supports the attribute, that is why it will still work even with a HTML5 !DOCTYPE. It won&apos;t be valid HTML5 however, but that may not be an issue for you if you want to support a particular kind of user experience, so I say &apos;Go for it!&apos;

&gt;aria-describedby or similar alternatives, in my view, may not be as robust as
&gt;the table summary.

They are excellent alternatives, and indeed the future. However, @summary is &apos;hidden&apos; by nature and aria-describedby will only point to an in page description and not a description in another URI. @summary for me was really good for the use cases that it supported (Blind, screen reader users who need a longer description for complex data tables) but the WG decided this wasn&apos;t good enough.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73445</commentid>
    <comment_count>4</comment_count>
    <who name="Devarshi Pant">devarshipant</who>
    <bug_when>2012-09-07 20:06:13 +0000</bug_when>
    <thetext>&gt; @Devarshi
&gt; The user agent (the screen reader) still supports the attribute, that is why it
&gt; will still work even with a HTML5 !DOCTYPE. It won&apos;t be valid HTML5 however,
&gt; but that may not be an issue for you if you want to support a particular kind
&gt; of user experience, so I say &apos;Go for it!&apos;

Will it help reinstating summary since it is easier to convince developers who are likely to use it but cannot because they want valid html5? I think the problem stems from its ill-advised use rather than due to the attribute itself.

&gt; &gt;aria-describedby or similar alternatives, in my view, may not be as robust as
&gt; &gt;the table summary.

&gt; They are excellent alternatives, and indeed the future. However, @summary is
&gt; &apos;hidden&apos; by nature and aria-describedby will only point to an in page
&gt; description and not a description in another URI. 

Granted ARIA is the future, but when used to substitute the summary attribute, it helps blind / low vision users.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81673</commentid>
    <comment_count>5</comment_count>
    <who name="Robin Berjon">robin</who>
    <bug_when>2013-01-21 15:58:16 +0000</bug_when>
    <thetext>Mass move to &quot;HTML WG&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81791</commentid>
    <comment_count>6</comment_count>
    <who name="Robin Berjon">robin</who>
    <bug_when>2013-01-21 16:01:00 +0000</bug_when>
    <thetext>Mass move to &quot;HTML WG&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83709</commentid>
    <comment_count>7</comment_count>
    <who name="steve faulkner">faulkner.steve</who>
    <bug_when>2013-02-26 07:23:41 +0000</bug_when>
    <thetext>EDITOR&apos;S RESPONSE: This is an Editor&apos;s Response to your comment. If you are
satisfied with this response, please change the state of this bug to CLOSED. If
you have additional information and would like the Editor to reconsider, please
reopen this bug. If you would like to escalate the issue to the full HTML
Working Group, please add the TrackerRequest keyword to this bug, and suggest
title and text for the Tracker Issue; or you may create a Tracker Issue
yourself, if you are able to do so. For more details, see this document:

   http://dev.w3.org/html5/decision-policy/decision-policy.html

Status: rejected
Change Description:none

The HTML5 specification provides [1] a method to expose an accessible name for a table that JAWS uses to label a table in the table list i.e. the provision of a caption.

Also the aria-label may be used in addition to the methods described by Josh in this bug thread.

All of the methods described (apart from use of summary)are conforming in HTML5.

[1] http://www.w3.org/html/wg/drafts/html/master/tabular-data.html#table-descriptions-techniques</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83721</commentid>
    <comment_count>8</comment_count>
    <who name="Devarshi Pant">devarshipant</who>
    <bug_when>2013-02-26 13:31:09 +0000</bug_when>
    <thetext>Steve,
Would it be possible to include one of the aria methods (label / describedby etc.) in Section 4.9: Tabular Data [http://www.w3.org/html/wg/drafts/html/master/tabular-data.html#table-descriptions-techniques]
thanks,
Devarshi

(In reply to comment #7)
&gt; EDITOR&apos;S RESPONSE: This is an Editor&apos;s Response to your comment. If you are
&gt; satisfied with this response, please change the state of this bug to CLOSED.
&gt; If
you have additional information and would like the Editor to reconsider,
&gt; please
reopen this bug. If you would like to escalate the issue to the full
&gt; HTML
Working Group, please add the TrackerRequest keyword to this bug, and
&gt; suggest
title and text for the Tracker Issue; or you may create a Tracker
&gt; Issue
yourself, if you are able to do so. For more details, see this
&gt; document:

   http://dev.w3.org/html5/decision-policy/decision-policy.html
&gt; Status: rejected
Change Description:none

The HTML5 specification provides
&gt; [1] a method to expose an accessible name for a table that JAWS uses to
&gt; label a table in the table list i.e. the provision of a caption.

Also the
&gt; aria-label may be used in addition to the methods described by Josh in this
&gt; bug thread.

All of the methods described (apart from use of summary)are
&gt; conforming in HTML5.

[1]
&gt; http://www.w3.org/html/wg/drafts/html/master/tabular-data.html#table-
&gt; descriptions-techniques</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83723</commentid>
    <comment_count>9</comment_count>
    <who name="Joshue O Connor">joshue.oconnor</who>
    <bug_when>2013-02-26 14:15:37 +0000</bug_when>
    <thetext>Sorry Devarshi if you think I closed the bug prematurely (technically it&apos;s your bug, although I did a lot of work on this issue - I have said all I have to). Do re-open if you&apos;re not happy, but for me this issue is closed.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83724</commentid>
    <comment_count>10</comment_count>
    <who name="steve faulkner">faulkner.steve</who>
    <bug_when>2013-02-26 14:34:40 +0000</bug_when>
    <thetext>its fine to leave it closed have pinged robin berjon for advice on adding aria technique to spec as suggested by Devarshi, will get back to you.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83726</commentid>
    <comment_count>11</comment_count>
    <who name="Devarshi Pant">devarshipant</who>
    <bug_when>2013-02-26 15:00:20 +0000</bug_when>
    <thetext>I am fine with how it currently stands. We probably should add one of the aria techniques under &apos;4.9.1.1 Techniques for describing tables’ to give more flexibility and options to developers. The latest post from Steve indicates that he is aware of it.
Thanks!


(In reply to comment #9)
&gt; Sorry Devarshi if you think I closed the bug prematurely (technically it&apos;s
&gt; your bug, although I did a lot of work on this issue - I have said all I
&gt; have to). Do re-open if you&apos;re not happy, but for me this issue is closed.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83744</commentid>
    <comment_count>12</comment_count>
    <who name="John Foliot">john</who>
    <bug_when>2013-02-26 17:21:59 +0000</bug_when>
    <thetext>Devarshi,

See also: http://lists.w3.org/Archives/Public/public-html/2011Apr/0091.html (Apr 2011)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83751</commentid>
    <comment_count>13</comment_count>
    <who name="Devarshi Pant">devarshipant</who>
    <bug_when>2013-02-26 18:48:18 +0000</bug_when>
    <thetext>John, the results are interesting. Personally, I will pick a technique from section 4.9 (including aria), but if a business rule is hardnosed about it, would push for the table summary (within the organization) – do not care if it fails validation as long as the user benefits.

(In reply to comment #12)
&gt; Devarshi,

See also:
&gt; http://lists.w3.org/Archives/Public/public-html/2011Apr/0091.html (Apr 2011)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83939</commentid>
    <comment_count>14</comment_count>
    <who name="steve faulkner">faulkner.steve</who>
    <bug_when>2013-03-04 15:05:28 +0000</bug_when>
    <thetext>(In reply to comment #11)
&gt; I am fine with how it currently stands. We probably should add one of the
&gt; aria techniques under &apos;4.9.1.1 Techniques for describing tables’ to give
&gt; more flexibility and options to developers. The latest post from Steve
&gt; indicates that he is aware of it.
&gt; Thanks!
&gt; 
&gt; 
&gt; (In reply to comment #9)
&gt; &gt; Sorry Devarshi if you think I closed the bug prematurely (technically it&apos;s
&gt; &gt; your bug, although I did a lot of work on this issue - I have said all I
&gt; &gt; have to). Do re-open if you&apos;re not happy, but for me this issue is closed.

Hi Devarshi, I have had some discussion with Robin Berjon the lead editor of the HTML spec and he thinks it is appropriate to add an aria technique so I will go ahead and do so and comment on bug when done.

thanks for your input!</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83954</commentid>
    <comment_count>15</comment_count>
    <who name="Devarshi Pant">devarshipant</who>
    <bug_when>2013-03-04 18:49:38 +0000</bug_when>
    <thetext>That is going to be quite helpful, Steve. Thanks!

(In reply to comment #14)
&gt; (In reply to comment #11)
&gt; I am fine with how it currently stands. We
&gt; probably should add one of the
&gt; aria techniques under &apos;4.9.1.1 Techniques
&gt; for describing tables’ to give
&gt; more flexibility and options to developers.
&gt; The latest post from Steve
&gt; indicates that he is aware of it.
&gt; Thanks!
&gt; 
&gt; &gt; 
&gt; (In reply to comment #9)
&gt; &gt; Sorry Devarshi if you think I closed the
&gt; bug prematurely (technically it&apos;s
&gt; &gt; your bug, although I did a lot of work
&gt; on this issue - I have said all I
&gt; &gt; have to). Do re-open if you&apos;re not
&gt; happy, but for me this issue is closed.

Hi Devarshi, I have had some
&gt; discussion with Robin Berjon the lead editor of the HTML spec and he thinks
&gt; it is appropriate to add an aria technique so I will go ahead and do so and
&gt; comment on bug when done.

thanks for your input!</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>85179</commentid>
    <comment_count>16</comment_count>
    <who name="steve faulkner">faulkner.steve</who>
    <bug_when>2013-03-30 18:22:45 +0000</bug_when>
    <thetext>EDITOR&apos;S RESPONSE: This is an Editor&apos;s Response to your comment. If you are
satisfied with this response, please change the state of this bug to CLOSED. If
you have additional information and would like the Editor to reconsider, please
reopen this bug. If you would like to escalate the issue to the full HTML
Working Group, please add the TrackerRequest keyword to this bug, and suggest
title and text for the Tracker Issue; or you may create a Tracker Issue
yourself, if you are able to do so. For more details, see this document:

   http://dev.w3.org/html5/decision-policy/decision-policy.html

Status: fixed
Change Description: added describedby example
refer to https://github.com/w3c/html/commit/3059a6a46a39015ef1735910b61bcd8e0a2c4bae

rationale: refer to Comment 15</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>