Provide a caption on tables

Applicable Role(s): Content Creator, Developer

Overview

Assistive technologies will read the caption or accessible name of tables on your page, making it especially important to have unique names/captions for each table. Multiple tables on a page without captions will make it difficult for assistive technology to tell one table from another.

Best Practices

  • Make the caption brief. This should be like alt text for an image.
  • The caption must be the first element with a <table> element.

Pattern Examples

Unique name describing table contents
Table Header Title Header Category Date
Link Data Data Data Data

Code

<table>
<caption>Unique name concisely describing 
table contents</caption> 
...
</table>

In Drupal:

Table properties dialog with caption field filled in