Using Captions to Identify Tables

Why are Table Captions important?

  • Standardize the way tables are displayed across your OER
  • Help screenreaders to find tables in a document and let the user decide if they want to read them

Video Demonstration

Watch Table Captions on Screencast-o-Matic (5 mins)

Video source:Table Captions” by Jen Booth, is licensed under CC BY-NC 4.0 , except where otherwise noted.

Process for Adding/Correcting Captions

Steps, timestamp in video explanation, Pressbooks editor required and related code snippet/sample
Step
Description Time stamp
Editor
1 Preview your page and determine if captions on tables are displaying in a consistent way. 0:36 Browser
2 Navigate to a table in Pressbooks editor. If the table does not have a caption (appears at top of the table surrounded by a dotted box/line), continue to #3 2:17 Visual
3 Select the table & access Table Properties from the menu 2:22 Visual
Table Properties
4 Click the checkbox for Caption & select OK 2:32 Table Properties
5 Add any existing caption / Table heading into the dotted box 2:49 Visual
6 If needed, remove table heading or extra cells once caption is in the caption field 3:11 Visual
7 Repeat for any further tables 3:25 Visual
8 If needed, check the HTML code to ensure caption is properly placed inside the table tag. 3:40 Text
8 Save & Preview. If captions appear at the bottom of the table rather than the top, notify your project team – we will change this via CSS. 4:02 Browser

The Finished Product

Table 6.2.1: The Modern and Common System of Cation Names
Element Stem Charge Modern Name Common Name
iron ferr- 2+ iron(II) ion ferrous ion
3+ iron(III) ion ferric ion
copper cupr- 1+ copper(I) ion cuprous ion
2+ copper(II) ion cupric ion
tin stann- 2+ tin(II) ion stannous ion
4+ tin(IV) ion stannic ion
lead plumb- 2+ lead(II) ion plumbous ion
4+ lead(IV) ion plumbic ion
chromium chrom- 2+ chromium(II) ion chromous ion
3+ chromium(III) ion chromic ion
gold aur- 1+ gold(I) ion aurous ion
3+ gold(III) ion auric ion

Source:  “3.4 Ionic Nomenclature” In The Basics of General, Organic, and Biological Chemistry by Saylor Academy, licensed under CC BY-NC-SA 3.0.

Table Summaries

Table Summaries are used in some older OER, and may or may not improve accessibility. In some cases, table summaries end up being a full list of every cell and it’s related data. This is likely not that useful to a screenreader.

View a sample of a table summary in HTML code

 

screenshot of table that is summarized in HTML code
Source: “9.3 Stoichiometry of Gaseous Substances, Mixtures, and Reactions” In Chemistry 2e (OpenStax) by Paul Flowers, Klaus Theopold, Richard Langley, & William R. Robinson, licensed under CC BY 4.0. Access for free at Chemistry 2e (OpenStax).

 

snippet of code that shows the placement of table summary tagging
Source: “9.3 Stoichiometry of Gaseous Substances, Mixtures, and Reactions” In Chemistry 2e (OpenStax) by Paul Flowers, Klaus Theopold, Richard Langley, & William R. Robinson, licensed under CC BY 4.0. Access for free at Chemistry 2e (OpenStax).

In this case, the summary repeats every data point from the table. This could be revised to just include information about the organization of the table, if necessary.

  • Check the HTML/Text version of your page to determine if a Table summary has been included.
  • Read the summary. An ideal summary should only list any pertinent details about the detail/layout of the table and/or why it’s included (context)
  • Table summary tags are deprecated in HTML 5, so:
    • It’s unclear if screenreaders actually access them and they may stop doing so
    • If they do, a lengthy table summary is not going to be helpful.
    • Recommendation is to put info in the Table caption, rather than a summary as it may not be supported

Resources

Attribution & References

Except where otherwise noted, “Using Captions to Identify Tables” by Jen Booth is licensed under CC BY-NC 4.0.

Media Attributions

License

Share This Book