This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 12053 - The current default ARIA role for the summary element in HTML5 is nonsensical
Summary: The current default ARIA role for the summary element in HTML5 is nonsensical
Status: RESOLVED FIXED
Alias: None
Product: HTML WG
Classification: Unclassified
Component: LC1 HTML5 spec (show other bugs)
Version: unspecified
Hardware: PC All
: P2 normal
Target Milestone: ---
Assignee: Ian 'Hixie' Hickson
QA Contact: HTML WG Bugzilla archive list
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-02-13 19:18 UTC by steve faulkner
Modified: 2012-01-13 09:52 UTC (History)
7 users (show)

See Also:


Attachments

Description steve faulkner 2011-02-13 19:18:10 UTC
change default role of summary from heading to none
It is starting to become clear that the summary element will be the interactive part of the details/summary disclosure widget.
in this case it needs to convey useful name/role and state information to AT.

below is the info i sent in response to question for advice on summary/details implementation:
the key points are that depending on the platform accessibility API the summary element will have a different role, as an interactive control it needs to convey that interactivity not a heading semantic.


http://lists.w3.org/Archives/Public/public-html/2011Feb/0238.html:

in order for the details/summary to be accessible to people with disabilities it needs to be hooked up to be able to receive focus, be operable with the keyboard and have role, name and state information exposed via accessibility APIs

below are some suggestions these:

I  would suggest the summary content act as the label for the disclosure triangle;
Clicking on the summary with a mouse will open/close the details element.
The summary should be keyboard focusable and when the spacebar is pressed it will open/close the details element.
as should a tap on a touch screen.

The summary element should be mapped to AXDisclosureTriangle[1] role in the Mac accessibility API.
the accessible name (AXTitle) for the disclosure triangle is the text content of the summary element.
when the details element open attribute is present, set  AXValue property to 1 on the summary element. 
when the details element open attribute is absent, set  AXValue property to 0 on the summary element. 


On windows where there is no disclosure triangle role map it to the ROLE_SYSTEM_PUSHBUTTON in MSAA [2]

the accessible name (accName) for the button is the text content of the summary element.
when the details element open attribute is present set  STATE_SYSTEM_EXPANDED on the summary element. 
when the details element open absent is present set  STATE_SYSTEM_COLLAPSED on the summary element. 


[1] http://developer.apple.com/library/mac/#documentation/Accessibility/Reference/AccessibilityCarbonRef/Reference/reference.html%23//apple_ref/doc/uid/TP40001082-CH1g-BAJGFBAF
[2] 
http://msdn.microsoft.com/en-us/library/dd373608(v=VS.85).aspx
http://msdn.microsoft.com/en-us/library/dd318466(v=VS.85).aspx
Comment 1 Martin Kliehm 2011-02-15 16:11:39 UTC
The bug-triage sub-team thinks this is a Accessibility Task Force priority, adding the a11yTF keyword.
Comment 2 Ian 'Hixie' Hickson 2011-05-03 19:53:24 UTC
EDITOR'S RESPONSE: This is an Editor'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: Accepted
Change Description: see diff given below
Rationale: Concurred with reporter's comments.
Comment 3 contributor 2011-05-03 19:54:18 UTC
Checked in as WHATWG revision r6054.
Check-in comment: Update ARIA role for <summary>.
http://html5.org/tools/web-apps-tracker?from=6053&to=6054
Comment 4 Michael[tm] Smith 2011-08-04 05:01:32 UTC
mass-moved component to LC1
Comment 5 steve faulkner 2012-01-13 09:52:14 UTC
removing keywords as is fixed