$table-accessibility

$table-accessibility — Accessibility settings for tables.

Parameter:

{}table-accessibility

Defined in:

param.xsl

Used in:

main.xsl, param.xsl

Synopsis

  |$table-accessibility as xs:string := 'summary details'

Description

The $table-accessibility parameter determines how accessibility features are added to CALS tables^*.

The value of this parameter is a space-separated list of strings. If the list contains:

summary: A summary attribute will be added to the table if an alt element or a textobject containing a single phrase is available.
details: A details element will be added if there is a textobject containing anything other than a single phrase available.

The list may contain either or both values. If other values are present, they are ignored.

See Example 1, “An example of table accessibility”.

   |<table frame="all">
   |   <title>Square numbers</title>
   |   <alt>The first four whole numbers
   |and their squares.</alt>
   |   <textobject>
   |      <para>This table shows the first four whole numbers
   |and their squares. (The square of a number is that
   |number times itself.)
   |</para>
   |   </textobject>
   |   <tgroup cols="2" colsep="1" rowsep="1">
   |      <thead>
   |         <row>
   |            <entry>
   |               <inlineequation>
   |                  <mathphrase>n</mathphrase>
   |               </inlineequation>
   |            </entry>
   |            <entry>
   |               <inlineequation>
   |                  <mathphrase>n<superscript>2</superscript>
   |                  </mathphrase>
   |               </inlineequation>
   |            </entry>
   |         </row>
   |      </thead>
   |      <tbody>
   |         <row>
   |            <entry>1</entry>
   |            <entry>1</entry>
   |         </row>
   |         <row>
   |            <entry>2</entry>
   |            <entry>4</entry>
   |         </row>
   |         <row>
   |            <entry>3</entry>
   |            <entry>9</entry>
   |         </row>
   |         <row>
   |            <entry>4</entry>
   |            <entry>16</entry>
   |         </row>
   |      </tbody>
   |   </tgroup>
   |</table>

Example 1. An example of table accessibility

One possible rendering of such an example:

Table 1. Square numbers

This table shows the first four whole numbers and their squares. (The square of a number is that number times itself.)

n	n²
1	1
2	4
3	9
4	16

Inspection of the HTML will reveal that the summary attribute is present on the element that wraps the table and a details element precedes it. These may or may not be rendered by your user agent depending on its accessibility features and settings.