Difference between revisions of "SummaryForTABLE/SummarySpecification"

From HTML WG Wiki
Jump to: navigation, search
(added WCAG 2 related see also links)
Line 30: Line 30:
 
* Please feel free to comment on ways the definition can be improved.
 
* Please feel free to comment on ways the definition can be improved.
 
* It is intended that usage examples be added.
 
* It is intended that usage examples be added.
 +
 +
== See Also ==
 +
 +
* [http://www.w3.org/TR/WCAG10-HTML-TECHS/#table-summary-info WCAG 2.0 5.1.1 Providing summary information]
 +
* [http://www.w3.org/TR/WCAG10/wai-pageauth.html#gl-table-markup WCAG 2.0 Checkpoint 5.5 Provide summaries for tables]
  
 
__NOTOC__
 
__NOTOC__

Revision as of 18:04, 27 February 2009

The summary attribute

The summary attribute represents a prose summary of the table's structure, primarily for user agents rendering to non-visual media such as speech and Braille. The value is text.

The primary purpose of the summary attribute is to provide guidance to people with vision impairments on how to read a table, where the structure and reading order is visually evident, but not available to some assistive technology users.

The summary attribute may be set on the table element if the data it contains is of sufficient complexity that users of non-visual user agents would benefit from a prose description of the table's structure. If the table contains data considered to only require a short description, use the caption element. Do not repeat the content of the caption element as content in the summary attribute.

The attribute may only be set on tables that contain tabular data. The attribute must not be set on tables used for layout purposes. The attribute should not be set to the empty string.

Any user agent may provide a mechanism to access the summary attribute content. If the mechanism provides the summary content as conditional content it must be input device independent.

The summary DOM attribute must reflect the summary content attribute.

Notes

  • This is a first attempt at defining the summary attribute in HTML 5.
  • Please feel free to comment on ways the definition can be improved.
  • It is intended that usage examples be added.

See Also